FIfiles
bundle_recipients
Bundle Recipients

List Share Link Recipients

Changed on

List Share Link Recipients

get/bundle_recipients

Request

  • Base URL
    https://app.files.com/api/rest/v1
  • URL
    https://app.files.com/api/rest/v1/bundle_recipients
  • Auth
    none declared

Query parameters

user_idinteger

User ID. Provide a value of 0 to operate the current session's user.

cursorstring

Used for pagination. When a list request has more records available, cursors are provided in the response headers X-Files-Cursor-Next and X-Files-Cursor-Prev. Send one of those cursor value here to resume an existing list from the next available record. Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.

per_pageinteger

Number of records to show per page. (Max: 10000, 1,000 or less is recommended).

If set, sort records by the specified field in either asc or desc direction. Valid fields are workspace_id.

If set, return records where the specified field is equal to the supplied value. Valid fields are has_registrations.

bundle_idinteger required

List recipients for the bundle with this ID.

Response

A list of BundleRecipients objects.

companystring

The recipient's company.

namestring

The recipient's name.

notestring

A note sent to the recipient with the bundle.

recipientstring

The recipient's email address.

sent_atstring date-time

When the Bundle was shared with this recipient.

workspace_idinteger

Workspace ID. 0 means the default workspace.

Example response

[
  {
    "company": "Acme Inc.",
    "name": "John Doe",
    "note": "Some note.",
    "recipient": "john.doe@example.com",
    "sent_at": "2000-01-01T01:00:00Z",
    "workspace_id": 1
  }
]

Changes

  • 3bb8c8a06041Revision changes
    • warning

      deleted the query request parameter filter_gt

    • warning

      deleted the query request parameter filter_gteq

    • warning

      deleted the query request parameter filter_like

    • warning

      deleted the query request parameter filter_lt

    • warning

      deleted the query request parameter filter_lteq

    • info

      api tag Bundle Recipients added

  • 334e0cf90234Revision changes
    • info

      endpoint added