> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gomry.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Contacts
> List contacts for your organization with pagination and filtering
# 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 number (starts at 1).
Number of contacts per page. Maximum: `200`.
Comma-separated list of statuses to include.
Allowed values: `active`, `inactive`.
Example: `?status=active`
Search contacts by email prefix. Case-insensitive.
Example: `?search=jane@`
## Response
Unique contact identifier
First name
Last name
Email address
Phone number
Contact status (`active` or `inactive`)
Job title
Company name
University name
Gender
Birthday
Location
LinkedIn URL
Instagram handle
Twitter handle
GitHub handle
Website URL
Array of tags
ISO 8601 creation timestamp
ISO 8601 last-updated timestamp
Total number of matching contacts
Current page number
Items per page
Total number of pages
```bash cURL theme={null}
curl -H "X-API-KEY: your_api_key" \
"https://www.gomry.com/api/v1/contacts?page=1&page_size=50"
```
```javascript JavaScript theme={null}
const response = await fetch(
"https://www.gomry.com/api/v1/contacts?page=1&page_size=50",
{ headers: { "X-API-KEY": "your_api_key" } }
);
const { data, pagination } = await response.json();
```
```json 200 theme={null}
{
"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
}
}
```