Audience

Get audience by ID

Changed on

Retrieve a specific audience by its ID. Note: if the audience belongs to a different organization, the API returns 404 (not 403) — ownership is deliberately obscured.

get/audience/{id}

Request

  • Base URL
    https://api.smallest.ai/atoms/v1
  • URL
    https://api.smallest.ai/atoms/v1/audience/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:60d0fe4f5311236168a109ca

The unique identifier of the audience

Response

Successfully retrieved audience

statusboolean

Example response

{
  "status": true,
  "data": {
    "_id": "60d0fe4f5311236168a109ca",
    "name": "My Customer List",
    "description": "List of customers for marketing campaign",
    "phoneNumberColumnName": "phoneNumber",
    "organization": "60d0fe4f5311236168a109cb",
    "createdBy": "60d0fe4f5311236168a109cc",
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:30:00.000Z"
  }
}

Changes

  • 2bfbd089ccb3Revision changes
    • breaking

      removed the media type application/json for the response with the status

    • info

      removed the non-success response with the status