Card Template Types

Get card template type

Returns a single card template type by its code.

GET /api/3/card_template_types/{code}

Authentication

This endpoint requires authentication:

OAuth 2.0 Recommended

Use an OAuth 2.0 access token in the Authorization header. This is the recommended authentication method for all integrations. OAuth provides automatic token expiration, granular permission scopes, detailed usage tracking, and per-integration revocation. Learn how to obtain an access token.

Header Format:

Authorization: Bearer YOUR_ACCESS_TOKEN

Required Scopes:

private.card_template_type.readonly

Parameters

Path Parameters

code string
Required

Card template type code

Responses

200

Card template type retrieved successfully

Response Fields

code string required

Unique identifier for this type

eg. ISO_CARD
name string required

Display name

eg. Standard ISO Card
page_size string

Physical page size category

eg. ISO_CARD
width_mm number

Physical width in millimetres

eg. 85.6
height_mm number

Physical height in millimetres

eg. 54.0
orientation_default string

Default orientation: P = Portrait, L = Landscape

eg. L
preview_image_url string | null

URL to a preview image, or null if not set

non_printable_zones array<object>

Non-printable zone definitions

created_at string

When the record was created

updated_at string

When the record was last updated

401

Unauthorized - Invalid or missing authentication

Response Fields

error string
eg. unauthorized
error_description string
eg. The access token is invalid
403

Forbidden - User does not have permission

Response Fields

error string
eg. forbidden
error_description string
eg. You are not authorized to access this resource
404

Not Found - Resource does not exist or is not an admission request event

Response Fields

error string
eg. not_found
error_description string
eg. The requested resource was not found
500

Internal Server Error

Response Fields

error string
eg. internal_server_error
error_description string
eg. An unexpected error occurred

Request

curl -X GET \
  "https://api.doorflow.com/api/3/card_template_types/{code}" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Responses

Card template type retrieved successfully

{
  "code": "ISO_CARD",
  "name": "Standard ISO Card",
  "page_size": "ISO_CARD",
  "width_mm": 85.6,
  "height_mm": 54.0,
  "orientation_default": "L",
  "preview_image_url": "string",
  "non_printable_zones": [
    {
      "label": "signature_stripe",
      "x_mm": "value",
      "y_mm": "value",
      "width_mm": "value",
      "height_mm": "value"
    }
  ],
  "created_at": "string",
  "updated_at": "string"
}