Search Organization
Search Organization
GET
Search organization records using one or more supported filters.
Request
GET
GET /v1/organization/search
Headers
- Authorization: Bearer your_access_token
Query Parameters
| Parameter | Type | Description |
|---|---|---|
organization_slug | string | Direct lookup by organization slug. Takes priority over other filters when provided. |
name | string | Organization name. |
website | string | Organization website or domain. |
linkedin_url | string | Organization LinkedIn URL. |
location | string | Organization location. |
address | string | Organization address. |
owner_id | integer | Owner user ID. |
owner_name | string | Owner full name. |
owner_email | string | Owner email address. |
created_from | ISO 8601 timestamp | Return organizations created at or after this timestamp. |
created_to | ISO 8601 timestamp | Return organizations created at or before this timestamp. |
updated_from | ISO 8601 timestamp | Return organizations updated at or after this timestamp. |
updated_to | ISO 8601 timestamp | Return organizations updated at or before this timestamp. |
exact_search | boolean string | Use true for exact text matching. Default: partial matching. |
sort_by | string | Allowed values: created_at, updated_at. Default: updated_at. |
sort_order | string | Allowed values: asc, desc. Default: desc. |
maximize | string | Comma-separated response expansions. Use all to expand all supported organization fields. |
page | integer | Page number. Default: 1. |
limit | integer | Records per page. Default: 25. Requests above 50 are capped at 50. |
Search Behavior
- Include at least one search filter to receive results.
organization_slugperforms a direct lookup and takes priority over all other filters.- Text filters use partial matching by default. Pass
exact_search=truefor exact text matching. - Date range filters are inclusive. For each date range, the
*_tovalue must be greater than or equal to the matching*_fromvalue. - Results are sorted by
updated_atin descending order unless sorting parameters are provided.
Supported maximize values
owner, created_by, updated_by, industry, all
Request Examples
Search by name
GET /v1/organization/search?name=Acme
Search by website
GET /v1/organization/search?website=acme.com
Exact name search
GET /v1/organization/search?name=Acme%20Corporation&exact_search=true
Search by owner
GET /v1/organization/search?owner_name=Rohan%20Sharma&maximize=owner
Direct slug lookup
GET /v1/organization/search?organization_slug=organization_d1d6d8323f07a6615f95
Response
200
{
"total": 1,
"per_page": 25,
"current_page": 1,
"last_page": 1,
"next_page_url": null,
"prev_page_url": null,
"from": 1,
"to": 1,
"data": [
{
"id": 28,
"slug": "organization_d1d6d8323f07a6615f95",
"name": "Acme Corporation",
"website": "acme.com",
"location": "San Francisco",
"address": "1 Market Street",
"owner": {
"id": 1
},
"socials": {
"linkedin": "https://www.linkedin.com/company/acme",
"xing": null
},
"created_at": "2026-06-21T02:49:00.000Z",
"updated_at": "2026-07-08T17:47:00.000Z"
}
]
}
400
[
{
"field_name": "created_to",
"error_message": "created_to must be greater than or equal to created_from"
}
]