GET /v1/contacts
const url = 'https://api.asap.cool/v1/contacts';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.asap.cool/v1/contacts \ --header 'Authorization: Bearer <token>'Authorizations
Section intitulée « Authorizations »Parameters
Section intitulée « Parameters »Query Parameters
Section intitulée « Query Parameters »Page size, 1..=100 (defaults to 50).
Opaque cursor from a previous page’s meta.next_cursor.
Free-text search over name / company / email (case-insensitive).
Filter by contact kind (particulier / professionnel).
Filter by lead pipeline stage (new/qualified/contacted/won/lost).
Filter by acquisition source (manual/chat/import/api).
Filter by tags (comma-separated); matches contacts carrying any of them.
When true, list archived contacts instead of active ones.
Responses
Section intitulée « Responses »Page of contacts (newest first).
Public projection of a [Contact] (omits unsubscribe_token).
object
Street address.
RFC3339 archival timestamp, or null when the contact is active.
City.
Company / legal name (business).
RFC3339 instant consent was last granted, or null.
Provenance of the recorded consent, or null.
ISO 3166-1 alpha-2 country code.
RFC3339 creation timestamp.
Per-contact default early-payment discount terms pre-filling a new
quote/invoice, or null to fall back to the org default.
Per-contact default payment terms pre-filling a new quote/invoice,
or null to fall back to the org default.
Contact email.
RFC3339 RGPD-erasure timestamp, or null when not erased.
Given name (individual).
Stable identifier.
RFC3339 timestamp of the last recorded interaction (chat reply,
email, …), or null when none.
Family name (individual).
Lead score in [0..=100], or null for a non-lead.
Lead pipeline stage, or null for a non-lead.
RGPD lawful basis (consent/contract/legitimate_interest/
legal_obligation), or null.
Current marketing-consent state.
Surviving contact this row was merged into (null for a live contact).
Free-form notes.
Phone number.
Postal / ZIP code.
Preferred language (fr or en) for outbound emails and documents,
or null when no explicit preference.
Whether the contact opted out of reminder emails.
French business registration number (14 digits).
Acquisition source (manual/chat/import/api).
Assigned tags (empty when none).
particulier or professionnel.
RFC3339 last-update timestamp.
Intra-EU VAT number (e.g. FR12345678901).
Example generated
[ { "address": "example", "archived_at": "example", "city": "example", "company": "example", "consent_at": "example", "consent_source": "example", "country": "example", "created_at": "example", "default_discount_terms": "example", "default_payment_terms": "example", "email": "example", "erased_at": "example", "first_name": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "last_interaction_at": "example", "last_name": "example", "lead_score": 1, "lead_status": "example", "legal_basis": "example", "marketing_consent": true, "merged_into": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "notes": "example", "phone": "example", "postal_code": "example", "preferred_language": "example", "reminder_opt_out": true, "siret": "example", "source": "example", "tags": [ "example" ], "type": "example", "updated_at": "example", "vat_intra": "example" }]No active org.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}Missing contacts:read scope.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}Invalid limit or cursor.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}