Find subscribers by phone number

The subscribers whose SMS number equals phoneNumber — normally one entry, an empty list when none. The number is a lookup key only and is never returned; the resources are the same as GET /subscribers/{id}. Phone number, email and names are never part of the response.

get

Authorizations

X-Recart-API-KeystringRequired

It can be obtained in Recart account after contacting Support

Query parameters

phoneNumberstringRequired

Phone number of the subscriber in E.164 format, with the leading plus

Example: [phone]Pattern: ^\+[1-9]\d{6,14}$

Responses

200

Ok

application/vnd.api+json

4XX

HTTP Error response

application/vnd.api+json

5XX

HTTP Error response

application/vnd.api+json

get/subscribers

GET /app-integrations/2023-12/subscribers?phoneNumber=%2B15550000000 HTTP/1.1
Host: api.recart.com
X-Recart-API-Key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "type": "subscribers",
      "attributes": {
        "id": "66aa0f1c7e8c9d2b00123abc",
        "timezone": "America/Chicago",
        "segments": [],
        "createdAt": "2026-03-04T18:22:10.000Z",
        "updatedAt": "2026-03-04T18:22:10.000Z",
        "sms": {
          "status": "subscribed",
          "subscribedAt": "2026-03-04T18:22:10.000Z",
          "lastInteractionAt": "2026-03-04T18:22:10.000Z",
          "subscriptionSource": {
            "type": "import",
            "id": "66b1c2d3e4f5a6b7c8d9e0f1",
            "name": "vip-customers-2026-03.csv"
          },
          "country": "US",
          "optinHistory": [
            {
              "type": "optin",
              "createdAt": "2026-03-04T18:22:10.000Z",
              "source": {
                "type": "import",
                "id": "66b1c2d3e4f5a6b7c8d9e0f1",
                "name": "vip-customers-2026-03.csv"
              }
            }
          ]
        }
      }
    }
  ]
}