curl -H "X-API-KEY: your_api_key" \
"https://www.gomry.com/api/v1/spaces?page=1&page_size=20"
const response = await fetch(
"https://www.gomry.com/api/v1/spaces?page=1&page_size=20",
{ headers: { "X-API-KEY": "your_api_key" } }
);
const { data, pagination } = await response.json();
{
"data": [
{
"id": "AbCdEfGhIjKlMnOpQrSt",
"identifier": "milan",
"name": "Milan",
"status": "active",
"color": "zinc",
"icon": "general",
"icon_type": "emoji",
"email": "milan@acme.com",
"linkedin": null,
"instagram": null,
"facebook": null,
"twitter": null,
"website": null,
"tax_details": {
"tax_type": "VAT",
"vat_number": "IT12345678901",
"vat_rate": 22,
"legal_entity_name": "ACME Milan SRL",
"legal_entity_address": "Via Roma 1, 20121 Milano",
"country": "IT",
"is_eu": true,
"is_valid_vat_number": true,
"notes_on_receipts": null
},
"created_at": "2025-03-01T10:00:00.000Z",
"updated_at": "2025-06-20T15:30:00.000Z"
}
],
"pagination": { "total": 1, "page": 1, "page_size": 20, "total_pages": 1 }
}
Spaces
List Spaces
List the spaces (sub-divisions) in your organization
GET
/
spaces
curl -H "X-API-KEY: your_api_key" \
"https://www.gomry.com/api/v1/spaces?page=1&page_size=20"
const response = await fetch(
"https://www.gomry.com/api/v1/spaces?page=1&page_size=20",
{ headers: { "X-API-KEY": "your_api_key" } }
);
const { data, pagination } = await response.json();
{
"data": [
{
"id": "AbCdEfGhIjKlMnOpQrSt",
"identifier": "milan",
"name": "Milan",
"status": "active",
"color": "zinc",
"icon": "general",
"icon_type": "emoji",
"email": "milan@acme.com",
"linkedin": null,
"instagram": null,
"facebook": null,
"twitter": null,
"website": null,
"tax_details": {
"tax_type": "VAT",
"vat_number": "IT12345678901",
"vat_rate": 22,
"legal_entity_name": "ACME Milan SRL",
"legal_entity_address": "Via Roma 1, 20121 Milano",
"country": "IT",
"is_eu": true,
"is_valid_vat_number": true,
"notes_on_receipts": null
},
"created_at": "2025-03-01T10:00:00.000Z",
"updated_at": "2025-06-20T15:30:00.000Z"
}
],
"pagination": { "total": 1, "page": 1, "page_size": 20, "total_pages": 1 }
}
List Spaces
Returns a paginated list of the active spaces in your organization. A space is a sub-division of an organization for running separate events — different cities, brands, teams, or (for a marketplace) sellers. Every event, experience, and contact belongs to a space and references it by itsidentifier (the space_identifier field on other endpoints).
The organization-wide GENERAL scope is synthetic — it is not a persisted
space and does not appear in this list. Target it elsewhere by omitting
space_identifier.
Requires the spaces:read scope.
Query Parameters
integer
default:"1"
Page number (starts at 1).
integer
default:"50"
Number of spaces per page. Maximum:
200.Response
array
Show Space object
Show Space object
string
Unique space identifier (document ID)
string | null
The human-set slug used as
space_identifier elsewherestring | null
Display name
string | null
activestring | null
Accent color token
string | null
Icon name or emoji
string | null
emoji or iconstring | null
Contact email shown on receipts
string | null
string | null
string | null
string | null
string | null
object | null
string | null
ISO 8601 creation timestamp
string | null
ISO 8601 last-updated timestamp
object
curl -H "X-API-KEY: your_api_key" \
"https://www.gomry.com/api/v1/spaces?page=1&page_size=20"
const response = await fetch(
"https://www.gomry.com/api/v1/spaces?page=1&page_size=20",
{ headers: { "X-API-KEY": "your_api_key" } }
);
const { data, pagination } = await response.json();
{
"data": [
{
"id": "AbCdEfGhIjKlMnOpQrSt",
"identifier": "milan",
"name": "Milan",
"status": "active",
"color": "zinc",
"icon": "general",
"icon_type": "emoji",
"email": "milan@acme.com",
"linkedin": null,
"instagram": null,
"facebook": null,
"twitter": null,
"website": null,
"tax_details": {
"tax_type": "VAT",
"vat_number": "IT12345678901",
"vat_rate": 22,
"legal_entity_name": "ACME Milan SRL",
"legal_entity_address": "Via Roma 1, 20121 Milano",
"country": "IT",
"is_eu": true,
"is_valid_vat_number": true,
"notes_on_receipts": null
},
"created_at": "2025-03-01T10:00:00.000Z",
"updated_at": "2025-06-20T15:30:00.000Z"
}
],
"pagination": { "total": 1, "page": 1, "page_size": 20, "total_pages": 1 }
}