Submission Types
Business+Read what exhibitors have to hand in (logo, catalogue text and so on), with allowed file types and size limits. The type_key is the type_key filter of /submissions.
Read Only
This endpoint only supports GET requests.
Required scopes:
submissions
Feature flag:
submissions
Endpoints
GET
/api/v1/submission-types
List submission types (active ones by default; is_active=all for every row)
GET
/api/v1/submission-types/{id}
Retrieve a single submission type
Query Parameters
| Parameter | Description |
|---|---|
is_active
|
Default: active entries only; 0 = only inactive, all = every entry |
page
|
Page number (default: 1) |
per_page
|
Results per page (default: 25, max. 100) |
Response Schema
| Field | Type |
|---|---|
id
|
integer |
type_key
|
string |
type_name
|
string |
description
|
string|null |
input_type
|
string |
custom_field_key
|
string|null |
allowed_extensions
|
array |
max_file_size_mb
|
integer |
is_required
|
boolean |
requires_approval
|
boolean |
category_keys
|
array |
help_text
|
string|null |
example_url
|
string|null |
is_active
|
boolean |
sort_order
|
integer |
event_count
|
integer |
created_at
|
string |
updated_at
|
string |
Code Examples
curl -X GET "https://your-tenant.plandocket.com/api/v1/submission-types" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"
<?php
$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://your-tenant.plandocket.com';
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $baseUrl . '/api/v1/submission-types',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
],
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
const apiKey = 'YOUR_API_KEY';
const baseUrl = 'https://your-tenant.plandocket.com';
const response = await fetch(`${baseUrl}/api/v1/submission-types`, {
method: 'GET',
headers: {
'Authorization': `Bearer ${apiKey}`,
},
});
const data = await response.json();
console.log(data);
import requests
api_key = 'YOUR_API_KEY'
base_url = 'https://your-tenant.plandocket.com'
headers = {
'Authorization': f'Bearer {api_key}',
}
response = requests.get(f'{base_url}/api/v1/submission-types', headers=headers)
data = response.json()
print(data)
Sample Response
200 OK
{
"data": [
{
"id": 1,
"type_key": "string",
"type_name": "string",
"description": "string",
"input_type": "string",
"custom_field_key": "string",
"allowed_extensions": [],
"max_file_size_mb": 1,
"is_required": true,
"requires_approval": true,
"category_keys": [],
"help_text": "string",
"example_url": "string",
"is_active": true,
"sort_order": 1,
"event_count": 1,
"created_at": "2026-01-15T10:00:00+01:00",
"updated_at": "2026-01-15T10:00:00+01:00"
}
],
"meta": {
"current_page": 1,
"per_page": 25,
"total": 1,
"total_pages": 1
}
}