Passa al contenuto principale

Exports Get​

A single export by id, with the parameters it was requested with. Poll it to follow the generation. Reserved to administrators.

Path Parameters
    export_id Export Id required
Responses

OK


Schema
    id Id required

    Unique identifier of the export.

    kind object

    An enumeration.

    format object

    An enumeration.

    state object

    An enumeration.

    label Label required

    Human-readable name of the export, built from its kind and the moment it ran.

    filename Filename

    Name of the generated file. Null until it is ready.

    rows_total Rows Total required

    Records written to the file.

    file_size File Size required

    Size of the file in bytes.

    expires_date date-time

    When the file is deleted. The export itself is kept as history.

    download_count Download Count required

    How many times the file has been downloaded.

    last_download_date date-time

    When the file was last downloaded.

    attempts Attempts required

    How many times the generation was attempted, retries included.

    task_id Task Id

    Identifier of the background task generating the file.

    filters object required

    The filters the export ran with, copied when it was requested. Empty when it ran over everything.

    from_selection From Selection required

    Whether the export ran over an explicit selection of records rather than filters.

    staff_name Staff Name

    Name of the staff member who requested the export. Null when it was not started by a person.

    segment_name Segment Name

    Name of the saved segment the export ran over. Null when it ran over ad-hoc filters.

    fields object[] required

    The columns the export was asked to produce, in the order they appear in the file.

  • Array [
  • key Key required

    Identifier of the column, as written in the file header.

    label Label required

    Human-readable name of the column. Falls back to the key when the column no longer exists.

  • ]
  • error_code object

    An enumeration.

    error_message Error Message

    Details of the failure. Null when it did not fail.

    script Script

    Post-processing script the export ran with. Null when it had none.

    download_url Download Url

    Address the file is served from with an Authorization: Bearer header. Null when the file is not ready or no longer available. Only administrators of the organization can download it.

    create_date date-time required

    When the export was requested.

    update_date date-time required

    When the export was last modified.

Loading...