POST /v1/codes/pdf417-generate
PDF417 code
The dense format used on boarding passes, tickets and the back of ID cards.
Make a stacked barcode now No key, no code — 2 credits either way.
curl -X POST "$DOATHING_API/v1/codes/pdf417-generate" \
-H "x-api-key: $DOATHING_KEY" \
-H "content-type: application/json" \
-d '{"text": "TICKET|A1234|2026-10-01|SEAT-14C"}'
The dense format used on boarding passes, tickets and the back of ID cards.
Generate a PDF417 stacked barcode with configurable columns and error-correction level.
Response
The result carries your remaining balance alongside it, so you can track spend without a second call.
{
"columns": 6,
"rows": 4,
"security_level": 2,
"encoded_bytes": 32,
"size": {
"width": 226,
"height": 74
},
"request_id": "37f01edb-0163-42a1-ac51-0acaef979800",
"credits_remaining": 96
}
Cost
2 credits per call, whether it is run from the site or from the API — the credential differs, the price does not. A new account starts with 20 credits.
A rejected request still costs a credit: the authorizer decrements before the tool validates. A call rejected for a missing or invalid key is free.
Parameters
Generated from the endpoint’s own validation, so this is exactly what it accepts. A body field goes at the top level; an option goes inside options.
| Name | In | Type | Default | Notes |
|---|---|---|---|---|
| text * | body | string | — | |
| columns | options | integer | 6 | Data columns, 1 to 30. More columns, fewer rows. 1 to 30 |
| security_level | options | integer | 2 | Error correction, 0 to 8. Print uses more. 0 to 8 |
| scale | options | integer | 3 | Pixels per module. 1 to 20 |
| row_height_ratio | options | integer | 3 | Row height as a multiple of module width. 1 to 10 |
| padding | options | integer | 10 | 0 to 60 |