Contacts
Get All Existing Exports
GET /v3/marketing/contacts/exports
Base url: https://api.sendgrid.com
Use this endpoint to retrieve details of all current exported jobs.
It will return an array of objects, each of which records an export job in flight or recently completed.
Each object's export_type
field will tell you which kind of export it is and its status
field will indicate what stage of processing it has reached. Exports which are ready
will be accompanied by a urls
field which lists the URLs of the export's downloadable files — there will be more than one if you specified a maximum file size in your initial export request.
Use this endpoint if you have exports in flight but do not know their IDs, which are required for the "Export Contacts Status" endpoint.
Authentication
- API Key
Headers
Responses
Export jobs ID.
Allowed values: pending
, ready
, or failure
.
This ISO8601 timestamp when the export was created.
This ISO8601 timestamp when the export was completed.
This ISO8601 timestamp when the export expires.
One or more download URLs for the contact file(s) if the status is ready
.
User ID.
Allowed types: contacts_export
, list_export
, or segment_export
.
Link to this page.
Link to next page.
the error message
the field that generated the error
helper text or docs for troubleshooting
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}
the error message
the field that generated the error
helper text or docs for troubleshooting
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}
the error message
the field that generated the error
helper text or docs for troubleshooting
{
"errors": [
{
"field": "field_name",
"message": "error message"
}
]
}
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.