List trash
Returns trash accessible to the API key’s account.
GET
/api/v1/trashtrash: read1,000 requests/minute/key · all plansActive API keys: Free 1, Pro 5, Pro+ 5. The request rate is the same on every plan.
Parameters
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
type | string | Optional | Filter or option: type. Allowed values: "directory", "member", "entry", "directoryLayout", "customFieldDefinition", "memberStatusDefinition", "frontSession". |
limit | integer | Optional | Filter or option: limit. Default: 200. Minimum: 1. Maximum: 500. |
Response schema
200
Successful response.
| Name | Type | Required | Description |
|---|---|---|---|
type | string | Required | Type. Allowed values: "member", "directory", "entry", "directoryLayout", "customFieldDefinition", "memberStatusDefinition", "frontSession". |
id | string | Required | Unique identifier. |
name | string | Required | Name of the resource. |
deletedAt | number | Required | Deletion time; null when active. |
purgeAt | number | Required | Purge At. |
originalLocation | string | Optional | Original Location. |
Errors
400· JSON errorRequest failed (BAD_REQUEST).
401· JSON errorMissing or invalid API key. Use Authorization: Bearer <token>.
403· JSON errorRequires trash: read; ownership or feature restrictions may also deny access.
429· JSON errorAPI rate limit exceeded (1000 requests per minute). Retry shortly.
Request example
Set FLORALITY_KEY in your environment. These examples use demo identifiers.
curl --request GET 'https://floralitys.com/api/v1/trash' \
--header "Authorization: Bearer $FLORALITY_KEY"Responses
Successful response.
[
{
"type": "member",
"id": "11111111-1111-4111-8111-111111111111",
"name": "River",
"deletedAt": 1767225600000,
"purgeAt": 1767225600000,
"originalLocation": "demo"
}
]Example values are illustrative demo data.