Get all spaces an account has access to

GET

https://api.contentful.com/spaces

GET

/spaces

$ curl -G https://api.contentful.com/spaces \
>      -H "X-Contentful-Organization: 1PLOOEmTI2S1NYald2TemO" \
>      -H "Authorization: Bearer <token>" \
>      -d skip=0 \
>      -d limit=100 \
>      -d order=-sys.createdAt \
>      -d cursor=true \
>      -d query=example \
>      -d type=Space

1 {
2   "sys": {
3     "type": "Array"
4   },
5   "total": 1,
6   "skip": 0,
7   "limit": 100,
8   "items": [
9     {
10       "sys": {
11         "type": "Space",
12         "id": "yadj1kx9rmg0",
13         "version": 3,
14         "organization": {
15           "sys": {
16             "id": "0D9ZC8rLWiw6x5qizZGiRs",
17             "type": "Link",
18             "linkType": "Organization"
19           }
20         },
21         "createdAt": "2025-06-04T11:58:18.000Z",
22         "createdBy": {
23           "sys": {
24             "type": "Link",
25             "linkType": "User",
26             "id": "7BslKh9TdKGOK41VmLDjFZ"
27           }
28         },
29         "updatedAt": "2026-01-05T11:02:17.000Z",
30         "updatedBy": {
31           "sys": {
32             "type": "Link",
33             "linkType": "User",
34             "id": "4FLrUHftHW3v2BLi9fzfjU"
35           }
36         }
37       },
38       "name": "Contentful Example API"
39     }
40   ]
41 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

X-Contentful-OrganizationstringOptional

Scope the listing to a specific organization. When omitted, spaces from all organizations the account has access to are returned.

Query parameters

skipintegerOptional

Number of resources to skip (offset pagination).

limitintegerOptional

Maximum number of resources to return.

orderstringOptional

Sort order, e.g. sys.createdAt or -sys.createdAt.

cursorbooleanOptional

When true, switches the response to cursor-based pagination. The response includes a pages object with next and prev URLs instead of skip/limit.

pageNextstringOptional

Cursor token for the next page. Use the value from pages.next in a previous cursor-paginated response.

pagePrevstringOptional

Cursor token for the previous page. Use the value from pages.prev in a previous cursor-paginated response.

querystringOptional

Search spaces by exact space ID match or partial name match.

typestringOptional

Filter by space type.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful