list_team_documents
View and filter team documents in your BoldSign organization by status, user, date range, or search terms to manage document workflows and track sent/received files.
Instructions
Retrieve a paginated list of documents available in the Team Documents section of your BoldSign organization. Team admins can view documents sent and received by team members, while account admins have access to all team documents across the organization. This API allows filtering based on status, user ID, team ID, document details, transmission type, and date range. If the user is not an account admin or team admin, an unauthorized response will be returned.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brandIds | No | Optional. Filters documents based on associated brand IDs. Only documents linked to the specified brands will be retrieved. | |
| dateFilterType | No | Optional. Type of date filter applied to documents. Available options: 'SentBetween' and 'Expiring'. | |
| endDate | No | Optional. End transmit date range of the document. The date should be in a valid date-time format. | |
| labels | No | Optional. Labels associated with documents. Used to filter the list by specific document tags. | |
| nextCursor | No | Optional. Cursor value for pagination beyond 10,000 records. Set to the cursor of the last retrieved document. | |
| page | Yes | ||
| pageSize | Yes | ||
| searchKey | No | Optional. A search term used to filter the document list. The API will return documents matching details like document title, document ID, sender name, or recipient name. | |
| startDate | No | Optional. Start transmit date range of the document. The date should be in a valid date-time format. | |
| status | No | Optional. Filter documents based on their current status. Available statuses include 'WaitingForMe', 'WaitingForOthers', 'NeedAttention', 'Completed', 'Declined', 'Revoked', 'Expired', 'Scheduled', and 'Draft'. Use 'None' to disable status filtering. | |
| teamId | No | Optional. Filter documents based on specific teams. One or more team IDs can be specified. | |
| transmitType | Yes | Optional. Type of transmission. Can be 'Sent', 'Received', or 'Both'. | Both |
| userId | No | Optional. Filter documents based on the list of team member IDs. One or more user IDs can be specified. |
Input Schema (JSON Schema)
{
"properties": {
"brandIds": {
"anyOf": [
{
"items": {
"description": "Unique identifier (ID) of the brand.",
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Optional. Filters documents based on associated brand IDs. Only documents linked to the specified brands will be retrieved."
},
"dateFilterType": {
"anyOf": [
{
"enum": [
"SentBetween",
"Expiring"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional. Type of date filter applied to documents. Available options: 'SentBetween' and 'Expiring'."
},
"endDate": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional. End transmit date range of the document. The date should be in a valid date-time format."
},
"labels": {
"anyOf": [
{
"items": {
"description": "Label of the document.",
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Optional. Labels associated with documents. Used to filter the list by specific document tags."
},
"nextCursor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Optional. Cursor value for pagination beyond 10,000 records. Set to the cursor of the last retrieved document."
},
"page": {
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"pageSize": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"searchKey": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional. A search term used to filter the document list. The API will return documents matching details like document title, document ID, sender name, or recipient name."
},
"startDate": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional. Start transmit date range of the document. The date should be in a valid date-time format."
},
"status": {
"anyOf": [
{
"items": {
"default": "None",
"enum": [
"None",
"WaitingForMe",
"WaitingForOthers",
"NeedAttention",
"Completed",
"Declined",
"Revoked",
"Expired",
"Scheduled",
"Draft"
],
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Optional. Filter documents based on their current status. Available statuses include 'WaitingForMe', 'WaitingForOthers', 'NeedAttention', 'Completed', 'Declined', 'Revoked', 'Expired', 'Scheduled', and 'Draft'. Use 'None' to disable status filtering."
},
"teamId": {
"anyOf": [
{
"items": {
"description": "The unique identifier (ID) of the team.",
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Optional. Filter documents based on specific teams. One or more team IDs can be specified."
},
"transmitType": {
"anyOf": [
{
"enum": [
"Sent",
"Received",
"Both"
],
"type": "string"
},
{
"type": "null"
}
],
"default": "Both",
"description": "Optional. Type of transmission. Can be 'Sent', 'Received', or 'Both'."
},
"userId": {
"anyOf": [
{
"items": {
"description": "The unique identifier (ID) of a user in the team.",
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Optional. Filter documents based on the list of team member IDs. One or more user IDs can be specified."
}
},
"required": [
"pageSize",
"page",
"transmitType"
],
"type": "object"
}