Substy Developers
Creators

Get custom order

Read one creator-scoped custom order, payment totals, deadline and the latest ten event receipts. Inspect sentAt, skippedAt, failedAt and lastError to distinguish confirmed sends, actions settled without a fan message (the AI may not write to the fan) and queued or failed actions.

GET/v1/agencies/{agencyId}/creators/{creatorId}/customs/orders/{orderId}

Read one creator-scoped custom order, payment totals, deadline and the latest ten event receipts. Inspect sentAt, skippedAt, failedAt and lastError to distinguish confirmed sends, actions settled without a fan message (the AI may not write to the fan) and queued or failed actions.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length
creatorId*string
Length1 <= length
orderId*string
Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agencies/string/creators/string/customs/orders/string" \  -H "Authorization: Bearer YOUR_API_KEY"
{  "data": {    "id": "string",    "what": "string",    "notIncluded": null,    "kind": "photo",    "requestedMinutes": null,    "minutes": null,    "pitchStep": 0,    "hasMadeConcession": true,    "move": "accept_offer",    "dueDate": null,    "status": "agreed",    "isAgencyNotified": true,    "price": null,    "fanOffer": null,    "paidAmount": {      "minor": 0,      "currency": "EUR"    },    "remainingAmount": null,    "currency": "EUR",    "creatorId": "string",    "fanId": "string",    "fanName": null,    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z",    "events": [      {        "id": "string",        "type": "delivered",        "amount": null,        "days": null,        "mediaIds": [          "string"        ],        "retryNumber": 0,        "appliedAt": null,        "queuedAt": null,        "sentAt": null,        "skippedAt": null,        "failedAt": null,        "lastError": null,        "createdAt": "2019-08-24T14:15:22Z"      }    ]  },  "meta": {    "requestId": "string"  }}

List custom orders GET

List up to 100 custom orders for one creator, filtered by one or several statuses, a fan, a search on the request and fan name, or work to do (to_deliver, or overdue against the given calendar day), sorted newest, oldest or by closest deadline (orders without one last). Follow nextCursor with the same filters and sort for later pages; total counts every match on the first page and is null on later pages. Includes payment totals and the latest ten event receipts per order.

Set custom order deadline POST

Register an ETA of 1–365 days for a fully paid custom order. Returns an asynchronous event receipt; refresh the order to confirm processing and the fan notification.