List PageMetas for a specific page
Retrieves a list of all page meta data for a specific page
HTTP Request
GET/api/pages/base/:page_id/meta/
NOTE: NOT USING THE TRAILING SLASH AT THE END OF THE URL RESULTS TO AN INTERNAL REDIRECT
Authorization
Authorization
- Required: Yes
- Permission: Staff with PageMetaPermission or Admin
- Permission Code: 3022
- Authentication: Token-based (Authorization: Token <your_api_key>)
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| page_id | Integer | Yes | Unique ID of the page |
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| limit | integer | 10 | Number of results per page |
| offset | integer | 0 | Number of results to skip |
| ordering | string | -created_at | Sort order (`id`, `key`, `value_text`, `created_at`, `updated_at`) |
| search | string | — | Search in (`key`, `value_text`, `value_file__name`) |
| id_min | integer | — | Minimum ID filter |
| id_max | integer | — | Maximum ID filter |
| created_date | string | — | Filter by creation date (e.g., 2023-01-01) |
| updated_date | string | — | Filter by last updated date (e.g., 2023-01-01) |
| created_from | string | — | Filter by creation date range start |
| created_to | string | — | Filter by creation date range end |
| updated_from | string | — | Filter by last updated date range start |
| updated_to | string | — | Filter by last updated date range end |
| has_value_text | boolean | _ | Filters meta with a text value |
| has_value_file | boolean | _ | Filters meta with a file value |
Example Requests
- 🐍 Python
- 🌐 Curl
1import requests
2
3# List Meta for a page
4response = requests.get('http://www.example.com/api/pages/base/38/meta',
5 headers={'Authorization': 'Token <your_api_key>'}
6)
7print(response.json())
8
9# List all meta for a page with text value
10response = requests.get('http://www.example.com/api/pages/base/38/meta', params={
11 'has_value_text': True,
12}, headers={'Authorization': 'Token <your_api_key>'})
13print(response.json())1# List meta for a page
2curl "http://www.example.com/api/pages/base/38/meta" \
3-H "Authorization: Token <your_api_key>"
4
5# List all meta for a page with text value
6curl "http://www.example.com/api/pages/base/38?has_value_text=true" \
7-H "Authorization: Token <your_api_key>"Response Fields
| Field | Type | Description |
|---|---|---|
| count | Integer | Total number of categories |
| next | String | URL for the next page of results |
| previous | String | URL for the previous page of results |
| results | Array[Object] | Array of PageMeta objects |
PageMeta Object Structure
| Field | Type | Description |
|---|---|---|
| id | Integer | Id of the meta(unique) |
| key | String | The key name of the meta |
| value_text | String | The text value related to the key (nullable) |
| value_file_data | object | The file value related to the key (nullable) |
| created_at | String (ISO 8601) | Timestamp when the page was created |
| updated_at | String (ISO 8601) | Timestamp when the page was last updated |
Value File Structure
| Field | Type | Description |
|---|---|---|
| id | Integer | Id of the file (unique) |
| type | String | Type of the file (image, text, video, ...) |
| name | String | File name (nullable) |
| size | String | Size of the file(nullable) |
| human_readable_size | String | A human readable size for the file |
| f | String | url to the file |
Example Response
{
"count": 3,
"next": null,
"previous": null,
"results": [
{
"id": 8,
"key": "text_about_us",
"value_text": "this is all about us",
"value_file_data": null,
"created_at": "2025-12-03T14:41:19.070933Z",
"updated_at": "2025-12-03T14:41:19.070937Z"
},
{
"id": 7,
"key": "image_bottom",
"value_text": "",
"value_file_data": {
"id": 2,
"type": "image",
"name": "logitech-mx-1",
"size": 4766,
"human_readable_size": "4.65 KB",
"f": "http://127.0.0.1:8000/media/core_media/2025/11/22/logitech-mx-1.jpg"
},
"created_at": "2025-12-03T14:41:19.069145Z",
"updated_at": "2025-12-03T14:41:19.069149Z"
},
{
"id": 1,
"key": "image_top",
"value_text": "",
"value_file_data": {
"id": 1,
"type": "image",
"name": "logitech-logo",
"size": 2763,
"human_readable_size": "2.70 KB",
"f": "http://127.0.0.1:8000/media/core_media/2025/11/22/logitech.png"
},
"created_at": "2025-11-23T10:18:36.325053Z",
"updated_at": "2025-12-03T14:40:53.987756Z"
}
]
}
NOTES
- A meta is only allowed to have either a
textorfileas the value (not both not none)