Skip to main content
GET
/
contacts
curl -H "X-API-KEY: your_api_key" \
  "https://www.gomry.com/api/v1/contacts?page=1&page_size=50"

{
  "data": [
    {
      "id": "AbCdEfGhIjKlMnOpQrSt",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@example.com",
      "phone_number": "+1234567890",
      "status": "active",
      "job_title": "Engineer",
      "company": "Acme Inc",
      "university": null,
      "gender": null,
      "birthday": null,
      "location": "New York",
      "linkedin": "https://linkedin.com/in/janedoe",
      "instagram": null,
      "twitter": null,
      "github": "janedoe",
      "website": null,
      "tags": ["vip", "speaker"],
      "created_at": "2025-03-01T00:00:00.000Z",
      "updated_at": "2025-06-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "page_size": 50,
    "total_pages": 1
  }
}

​
List Contacts

Returns a paginated list of contacts belonging to your organization.
email, first_name, and last_name are backfilled from each contact’s linked user account when the contact record itself stores them empty. A value stored directly on the contact always takes precedence. No extra scope is required — this comes with contacts:read.

​
Query Parameters

​
page
integer
default:"1"
Page number (starts at 1).
​
page_size
integer
default:"50"
Number of contacts per page. Maximum: 200.
​
status
string
default:"active,inactive"
Comma-separated list of statuses to include.Allowed values: active, inactive.Example: ?status=active
​
search
string
Search contacts by email prefix. Case-insensitive.Example: ?search=jane@

​
Response

​
data
array
​
pagination
object
curl -H "X-API-KEY: your_api_key" \
  "https://www.gomry.com/api/v1/contacts?page=1&page_size=50"

{
  "data": [
    {
      "id": "AbCdEfGhIjKlMnOpQrSt",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@example.com",
      "phone_number": "+1234567890",
      "status": "active",
      "job_title": "Engineer",
      "company": "Acme Inc",
      "university": null,
      "gender": null,
      "birthday": null,
      "location": "New York",
      "linkedin": "https://linkedin.com/in/janedoe",
      "instagram": null,
      "twitter": null,
      "github": "janedoe",
      "website": null,
      "tags": ["vip", "speaker"],
      "created_at": "2025-03-01T00:00:00.000Z",
      "updated_at": "2025-06-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "page_size": 50,
    "total_pages": 1
  }
}