List contacts

ProRead key

Available on the Pro and Enterprise plans (beta).

GET…/public/contacts

Returns the contacts, one page at a time.

Request
curl https://app.reshta.ir/api/v1/public/contacts \​  -H "Authorization: Bearer $RESHTA_API_KEY"​

Headers

AuthorizationstringrequiredBearer followed by the business API key (rk_live_…).

Query parameters

owner_idstringoptionalThe responsible teammate.
qstringoptionalSearch text.
cursorstringoptionalnext_cursor from the previous response; leave out for the first page.
limitstringoptionalPage size; default 50, at most 100.

Responses and errors

200—Success.
401unauthorizedThe key is missing, wrong or revoked, or its creator is no longer active.
429rate_limitedOver 120 requests per minute; Retry-After says how many seconds to wait.
Response
{​  "data": [​    { "id": "0192c4e8-7b1a-7c3e-9f20-5d6a1b2c3d4e", "first_name": "سارا", "last_name": "رضایی", … },​    { "id": "0192c4f9-0a2b-7c4d-8e5f-60718293a4b5", "first_name": "نگار", "last_name": "احمدی", … }​  ],​  "next_cursor": "eyJpZCI6IjAxOTJjNGY5In0"​}​

Create an API key and send your first request

Keys are created in the Reshta app and shown once. The API and webhooks (beta) are on the Pro and Enterprise plans, and only a business admin can create a key.

  1. 1Sign in at app.reshta.ir
  2. 2Connection → Developer
  3. 3Create API key