List registration attachments
/v1/compliance/attachmentsfor await (const attachment of bird.complianceAttachments.list()) {
console.log(attachment.id, attachment.filename, attachment.status);
}for attachment in client.compliance_attachments.list():
print(attachment.id, attachment.filename, attachment.status)for attachment, err := range client.ComplianceAttachments.List(context.Background(), bird.ComplianceAttachmentsListParams{}) {
if err != nil {
log.Fatal(err)
}
fmt.Println(attachment.Id, attachment.Status)
}foreach ($bird->complianceAttachments->list() as $attachment) {
echo $attachment->getId(), ' ', $attachment->getFilename(), ' ', $attachment->getStatus(), "\n";
}bird compliance attachments listcurl -X GET "https://us1.platform.bird.com/v1/compliance/attachments" \
-H "Authorization: Bearer $TOKEN" \
--url-query "sort=created_at" \
--url-query "order=desc" \
--url-query "limit=25" \
--url-query "include_total=false"{
"data": [
{
"created_at": "2026-05-20T09:14:52Z",
"updated_at": "2026-05-25T16:42:01Z",
"id": "tca_01krdgeqcxet5s7t44vh8rt9mg",
"status": "draft"
}
],
"next_cursor": "eyJ2IjoxLCJzIjoiXCIyMDI2LTA1LTI1VDE0OjAzOjEwWlwiIiwiaSI6IjAxOTJmM2IxLTRjN2UtN2EyYi05ZDYxLThmM2E1YzJlN2I0MCJ9",
"prev_cursor": null,
"refresh_cursor": "eyJ2IjoxLCJzIjoiXCIyMDI2LTA1LTI1VDE2OjQyOjAxWlwiIiwiaSI6IjAxOTJmM2IxLTllMDQtN2NkMy1iODE3LTJhNmY0ZDFjOGUwOSJ9"
}
Returns the registration attachments uploaded for the workspace, most recent first. Use this to offer a previously uploaded file for reuse on a new registration instead of uploading it again. Attachments that were never cited by a registration and have expired are not listed.
查询参数
sortstringField to sort by. Defaults to created_at.
Possible values: created_at
orderstringSort direction. Defaults to desc, which sorts from newest to oldest or largest to smallest, depending on the selected sort field.
Possible values: asc, desc
limitintegerMaximum number of items to return per page.
starting_afterstringCursor from the next_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order.
ending_beforestringCursor from the prev_cursor or refresh_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order. prev_cursor returns the preceding page. refresh_cursor anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
include_totalbooleanWhen true, the response includes a total field with the total number of items matching the request's filters across all pages.
响应载荷
data显示子属性
data.created_atdata.updated_atdata.iddata.filenameThe uploaded file's name.
data.content_typeThe file's content type, determined from its contents.
data.size_bytesThe file's size in bytes.
data.descriptionA short note describing what the file shows.
data.statusLifecycle of an attachment. draft is a file that has been uploaded but nothing
has been registered or submitted with it yet, and it is discarded at its
expires_at. attached means at least one registration has cited it, so it is
kept permanently and can no longer be deleted.
Possible values: draft, attached
data.download_urlShort-lived signed URL for downloading or previewing the attachment. Valid for 24 hours from when the resource was fetched; request a fresh resource to obtain a new URL after expiry. Do not cache beyond download_url_expires_at. Registration authorities (10DLC and toll-free carriers) retrieve evidence via a separate, longer-lived token; this URL is not that token.
data.preview_urlOptional signed URL for inline viewing on an isolated storage origin. Valid for one hour; fetch the attachment again to refresh it.
data.download_url_expires_atWhen download_url expires. Both fields are always present; the server returns an error rather than omitting them.
data.expires_atWhen this attachment is discarded if nothing is registered or submitted with it. Null once its status is attached.
next_cursorCursor for the next page. Pass back as starting_after to advance forward. null when no next page exists.
prev_cursorCursor for the previous page. Pass back as ending_before to step backward. null when no previous page exists.
refresh_cursorRefresh anchor, the first row of this response. Pass back as ending_before to fetch what precedes it in the current sort order. On a newest-first sort those are the items that have appeared since; on any other sort they are the items that sort earlier, so refreshing such a list means re-fetching it instead. Non-null whenever data is non-empty; null only on an empty page. Distinct from prev_cursor.
totalTotal number of items matching the request's filters across all pages. Present only when include_total=true was passed; otherwise null.