Compliance Documents resource

(new)

Private beta

The Trust Hub API resources for Branded Calling are in private beta, and the information contained in this document is subject to change. This means that some features aren't yet implemented and others may be changed before the product is declared as generally available. Private beta products aren't covered by a Service Level Agreement (SLA).

To request access, complete the request form.

A Compliance Document resource represents a Letter of Authorization (LOA) required for compliance verification. Customers must provide a signed LOA for their brand.

See Related how-to documentation to learn the steps to use the info on this page.

Create a Compliance Document

POST https://trusthub.twilio.com/v4/Compliance/Documents

Form parameters

Note: This request uses form parameters (--form). The --form option sends data as multipart/form-data, and each --form line represents a separate form parameter in the request body.

Parameter	Type	Required	Description
`type`	string	Yes	The type of the Compliance Document. The value must be `LETTER_OF_AUTHORIZATION`.
`friendlyName`	string	Yes	A friendly name for the Document.
`content`	string($binary)	Yes	The file to upload. Supported formats: `application/pdf`, `image/jpeg`, `image/png`

Create a Compliance Document

1curl -X POST 'https://trusthub.twilio.com/v4/Compliance/Documents' \
2--form 'type="LETTER_OF_AUTHORIZATION"' \
3--form 'content=@"/Users/John/Documents/loa.jpg"' \
4--form 'friendlyName="letter of auth doc"'
5-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "contentType": "image/jpeg",
3  "contentUrl": "https://trusthub.twilio.com/v4/Compliance/Documents/RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Content",
4  "dateCreated": "2025-10-16T10:28:15Z",
5  "dateUpdated": "2025-10-16T10:28:15Z",
6  "friendlyName": "letter of auth doc",
7  "id": "RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
8  "type": "LETTER_OF_AUTHORIZATION"
9}

Retrieve a list of Compliance Documents

GET https://trusthub.twilio.com/v4/Compliance/Documents

Query parameters

Parameter	Type	Description
`type`	string	The type of the Compliance Document. The value must be `LETTER_OF_AUTHORIZATION`
`pageSize`	integer	The maximum number of items to return in a single response. Min: 1 Max: 1000 Default: 50
`pageToken`	string	A URL-safe, Base64-encoded token that specifies which page of results to return. This token contains the position information needed to retrieve the next set of results. If not specified, the API returns the first page of results.

Retrieve a list of Compliance Documents

1curl -X GET 'https://trusthub.twilio.com/v4/Compliance/Documents?type=LETTER_OF_AUTHORIZATION&pageSize=2' \
2-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "items": [
3    {
4      "contentType": null,
5      "contentUrl": null,
6      "dateCreated": "2025-10-17T10:12:05Z",
7      "dateUpdated": "2025-10-17T10:12:05Z",
8      "friendlyName": "LOA",
9      "id": "RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
10      "type": "LETTER_OF_AUTHORIZATION"
11    },
12    {
13      "contentType": null,
14      "contentUrl": null,
15      "dateCreated": "2025-10-17T09:59:16Z",
16      "dateUpdated": "2025-10-17T09:59:16Z",
17      "friendlyName": "Letter of Auth doc",
18      "id": "RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
19      "type": "LETTER_OF_AUTHORIZATION"
20    }
21  ],
22  "meta": {
23    "key": "items",
24    "nextToken": "eyJwb2ludGVyIjoiUkRhYzYzNGYwNzVkZDc3NjBiNDE5MjYyODRlZDY5ODI4ZCIsImRpcmVjdGlvbiI6Ik5FWFQifQ==",
25    "pageSize": 2,
26    "previousToken": null
27  }
28}

Retrieve metadata for a Compliance Document

GET https://trusthub.twilio.com/v4/Compliance/Documents/{id}

Path parameters

Parameter	Type	Required	Description
`id`	string	Yes	The ID of the Compliance Document. Pattern: `^RD[0-9a-fA-F]{32}$` Min length: 34 Max length: 34

Retrieve metadata for a Compliance Document

1curl -X GET 'https://trusthub.twilio.com/v4/Compliance/Documents/RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' \
2-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Output

1{
2  "contentType": "image/jpeg",
3  "contentUrl": "https://trusthub.twilio.com/v4/Compliance/Documents/RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Content",
4  "dateCreated": "2025-10-16T18:48:39Z",
5  "dateUpdated": "2025-10-16T18:48:39Z",
6  "friendlyName": "letter of auth doc",
7  "id": "RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
8  "type": "LETTER_OF_AUTHORIZATION"
9}

Retrieve the content of a Compliance Document

GET https://trusthub.twilio.com/v4/Compliance/Documents/{id}/Content

Download an existing Compliance Document.

Path parameters

Parameter	Type	Required	Description
`id`	string	Yes	The ID of the Compliance Document. Pattern: `^RD[0-9a-fA-F]{32}$` Min length: 34 Max length: 34

Retrieve the content of a Compliance Document

1curl -X GET 'https://trusthub.twilio.com/v4/Compliance/Documents/RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Content' \
2-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Delete a Compliance Document

DELETE https://trusthub.twilio.com/v4/Compliance/Documents/{id}

Path parameters

Parameter	Type	Required	Description
`id`	string	Yes	The ID of the Document. Pattern: `^RD[0-9a-fA-F]{32}$` Min length: 34 Max length: 34

Delete a Compliance Document

1curl -X DELETE 'https://trusthub.twilio.com/v4/Compliance/Documents/RDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' \
2-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN