latestOpenAPI 3.0.3MIT2026-08-10102048.8 KB

b49d3ae283fd

brands

Get a brand by project and brand id.

The endpoint receives as path param project id and brand id. If the project and brand exist, the details of the brand are returned.

get/v1/projects/{projectId}/brands/{brandId}

Path parameters

projectIdstring required

Customer's project id

brandIdstring required

Customer's brand id

Response

OK

brandIdstring

The unique identifier for the brand.

brandNamestring

The name of the brand.

brandMetadataIdstring

The unique identifier for the brand metadata.

status'DRAFT' | 'NEW' | 'PENDING' | 'PENDING_REVIEW' | 'REJECTED' | 'INCOMPLETE' | 'COMPLETED' | 'ARCHIVED' enum
dataBrandCategory[]

The list of categories included in the brand metadata. Each of them includes a list of attributes.

callbackUrlstring

The URL to receive the brand status update callback. The URL must be a valid URL and must be reachable from Sinch.

createTimestring date-time

The date and time when the brand was created.

updateTimestring date-time

The date and time when the brand was updated.

Example response

{
  "brandId": "1234567890",
  "brandName": "My End Customer Brand Name",
  "brandMetadataId": "4444444444",
  "status": "INCOMPLETE",
  "data": [
    {
      "companyName": "My Company Name",
      "website": "https://www.mycompany.com",
      "employeeCount": 150,
      "isPublic": false
    }
  ],
  "logs": [
    {
      "status": "INCOMPLETE",
      "createTime": "2023-10-01 12:00:00+00:00",
      "comment": "Brand created successfully.",
      "author": "CUSTOMER"
    }
  ],
  "callbackUrl": "https://example.com/callback",
  "createTime": "2023-10-01 12:00:00+00:00",
  "updateTime": "2023-10-01 12:00:00+00:00"
}