PlanDocket

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
Access level: GET submissions:read About access levels
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
    }
}