Get all organizations
GET {{baseUrl}}/organizations?filter_id=<integer>&ids=<string>&owner_id=<integer>&updated_since=<string>&updated_until=<string>&sort_by=id&sort_direction=asc&include_fields=<string>&custom_fields=<string>&limit=<integer>&cursor=<string>
Returns data about all organizations.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
filter_id | string | If supplied, only organizations matching the specified filter are returned | |
ids | string | Optional comma separated string array of up to 100 entity ids to fetch. If filter_id is provided, this is ignored. If any of the requested entities do not exist or are not visible, they are not included in the response. | |
owner_id | string | If supplied, only organization owned by the specified user are returned. If filter_id is provided, this is ignored. | |
updated_since | string | If set, only organizations with an update_time later than or equal to this time are returned. In RFC3339 format, e.g. 2025-01-01T10:20:00Z. | |
updated_until | string | If set, only organizations with an update_time earlier than this time are returned. In RFC3339 format, e.g. 2025-01-01T10:20:00Z. | |
sort_by | string | The field to sort by. Supported fields: id, update_time, add_time. | |
sort_direction | string | The sorting direction. Supported values: asc, desc. | |
include_fields | string | Optional comma separated string array of additional fields to include | |
custom_fields | string | Optional comma separated string array of custom fields keys to include. If you are only interested in a particular set of custom fields, please use this parameter for faster results and smaller response.<br/>A maximum of 15 keys is allowed. | |
limit | string | For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed. | |
cursor | string | For pagination, the marker (an opaque string value) representing the first item on the next page |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"success":true,"data":[{"id":1,"name":"Organization Name","owner_id":1,"org_id":1,"add_time":"2021-01-01T00:00:00Z","update_time":"2021-01-01T00:00:00Z","address":{"value":"123 Main St","country":"USA","admin_area_level_1":"CA","admin_area_level_2":"Santa Clara","locality":"Sunnyvale","sublocality":"Downtown","route":"Main St","street_number":"123","postal_code":"94085"},"is_deleted":false,"visible_to":7,"label_ids":[1,2,3],"custom_fields":{}}],"additional_data":{"next_cursor":"eyJmaWVsZCI6ImlkIiwiZmllbGRWYWx1ZSI6Nywic29ydERpcmVjdGlvbiI6ImFzYyIsImlkIjo3fQ"}}