crate::web::openapi::recipients

GET /v1/customers/{customer_id}/recipients/list

Changed on

Request

Path parameters

customer_idstring required

Unique identifier of the customer

Query parameters

searchstring

Search string to filter by name, nickname, or email

pageinteger

Page number (starts from 1, default: 1)

sizeinteger

Number of items per page (1-100, default: 10)

Response

Successfully retrieved list of recipients

totalinteger nullable

Example response

{
  "list": [
    {
      "recipient_id": "4728c2b9-6df7-11f0-b1f6-6a7838eca3f8",
      "customer_id": "14f20ebd-893b-11f0-b308-2eaa4f6974f2",
      "business_type": "INDIVIDUAL",
      "full_name": "John Doe",
      "nickname": "John's Business",
      "email": "john.doe@example.com",
      "relationship": "VENDOR",
      "status": "success",
      "address": {
        "full_address": "490 2nd St Suite 300, San Francisco, CA 94107",
        "country_code": "USA",
        "address_line1": "490 2nd St",
        "address_line2": "Suite 300",
        "city": "San Francisco",
        "region": "CA",
        "postal_code": "94107"
      },
      "action_required": {
        "type": "RFI",
        "case_id": "TC-WXYZ-2345",
        "action": "SUBMIT_INFORMATION"
      },
      "created_at": "2025-10-29T02:46:25.096305Z",
      "modified_at": "2025-10-29T02:46:25.096305Z"
    }
  ],
  "total": 1024
}

Changes

    • breaking

      for the query request parameter page, default value 1 was added

    • breaking

      for the query request parameter size, default value 10 was added

    • breaking

      for the query request parameter page, the min was increased from 0.00 to 1.00

    • breaking

      for the query request parameter size, the min was increased from 0.00 to 1.00

    • warning

      for the query request parameter size, the max was set to 100.00

    • info

      api tag crate::web::openapi::recipients added

    • info

      api tag Recipients (Send to Others) removed

    • info

      added the optional property // to the response with the status