Sourcings

As a Seller, you can create and view your sourcing requests via the API.

Create Sourcing

POST/sourcings Bearer Token — create sourcings

Submit a new sourcing request.

Request body: form fields and files follow the same rules as the dashboard (at minimum a unique name for the request).

Response

Success (201):

{
  "data": {
    "reference": "SRC-00001"
  },
  "meta": {}
}

Validation error (422): same envelope as Error handling (error.code, error.message, optional error.fields).

List Sourcings

GET/sourcings Bearer Token

Retrieve a paginated list of your sourcing requests.

Parameter	Type	Required	Description
per_page	number	No	Results per page

Response

Success (200):

{
  "data": [
    {
      "id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "reference": "SRC-00001",
      "status": "pending",
      "created_at": "2025-01-12T14:00:00Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 18,
      "pages": 1
    }
  }
}

INFO

Only list and create are exposed. There is no GET /sourcings/{id}/show endpoint.