Facilities
Pickup and delivery locations.
List facilities
GET/v1/facilities
Newest first, a page at a time. See Pagination and syncing.
curl "https://harlo-api-dev.pages.dev/v1/facilities?limit=10" \
-H "Authorization: Bearer $HARLO_API_KEY"Paging, order and format
| Parameter | What it does |
|---|---|
limit | How many to return, 1 to 100.Default: 25 |
cursor | `next_cursor` from the previous page. |
sort | Order: newest first by default.Values: -created_at, created_at, -updated_at, updated_atDefault: -created_at |
updated_since | Only records changed at or after this ISO 8601 time. |
created_since | Only records created at or after this ISO 8601 time. |
format | `csv` returns the page as a spreadsheet: nested fields become columns like `customer.name`.Values: json, csvDefault: json |
Retrieve a facility
GET/v1/facilities/{id}
curl "https://harlo-api-dev.pages.dev/v1/facilities/ca799378-f757-4bb2-8b55-6a64a3d07ec9" \
-H "Authorization: Bearer $HARLO_API_KEY"Example response
{
"id": "ca799378-f757-4bb2-8b55-6a64a3d07ec9",
"object": "facility",
"number": "F-0002",
"name": "Gulf Coast Grocers",
"type": "warehouse",
"status": "onboarding",
"timezone": "America/Chicago",
"appointment_required": false,
"contact": {
"name": null,
"phone": null,
"email": null
},
"address": {
"line1": "4200 Irving Boulevard",
"city": "Dallas",
"state": "TX",
"postal_code": "75247",
"country": "USA",
"formatted": "4200 Irving Boulevard, Dallas, TX, USA",
"latitude": 32.807353,
"longitude": -96.888234
},
"created_at": "2026-11-14T06:23:27.996808+00:00",
"updated_at": "2026-11-14T06:23:28.604471+00:00"
}The facility object
| Field | Type | What it is |
|---|---|---|
id | id | Unique id of the facility. |
object | string | Always "facility". |
number | string, nullable | |
name | string | |
type | string, nullable | |
status | string, nullable | |
timezone | string, nullable | |
appointment_required | boolean, nullable | |
contact | object | |
name | string, nullable | |
phone | string, nullable | |
email | string, nullable | |
address | object | |
line1 | string, nullable | |
city | string, nullable | |
state | string, nullable | |
postal_code | string, nullable | |
country | string, nullable | |
formatted | string, nullable | The whole address on one line. |
latitude | number, nullable | |
longitude | number, nullable | |
created_at | timestamp, nullable | When it was created. |
updated_at | timestamp, nullable | When it last changed. Use with `updated_since` to sync. |