PARSER GUIDES

Create Parser

POST

/api/v1/parsers

Create a parser with optional initial fields. To create a document classifier, use /api/v1/classifiers.

Authorization

bearerAuth

authorization: <token>

Your API key. Include it directly in the Authorization header as the API key value (e.g., 'authorization: your-api-key-here')

In: header

Request Body

application/json

name — string

description?string

type?string

acceptedFileTypes?array<string\>

Accepted file MIME type strings.

fields?array<PublicField\>

Response Body

201

application/json

400

application/json

curl -X POST "https://api.PARSER.com/api/v1/parsers" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'

201400

{
  "id": "d1458cd7-8692-488f-8b3f-0fddade05f9c",
  "name": "Invoice Parser",
  "description": "Extracts purchase order and invoice fields.",
  "type": "document",
  "isActive": true,
  "acceptedFileTypes": [
    {
      "mimeType": "application/pdf",
      "label": "PDF"
    }
  ],
  "settings": {
    "acceptedFileTypes": [
      {
        "mimeType": "application/pdf",
        "label": "PDF"
      }
    ],
    "confidenceScores": {
      "enabled": true
    },
    "markdownParsing": {
      "enabled": true
    },
    "advancedTableExtraction": "disabled",
    "dataExtractionMode": "fast",
    "splitDocuments": {
      "enabled": true,
      "mode": "everyXPages",
      "everyXPages": 5,
      "pageRanges": "1, 3, 7-9",
      "instructions": "Each invoice starts with an invoice number at the top.",
      "partitionKey": "transactions.transaction_date",
      "partitionKeySource": "parserField"
    },
    "classificationGate": {
      "enabled": true,
      "mode": "allow",
      "labels": [
        "Invoice",
        "Purchase Order"
      ],
      "instructions": "Only accept vendor invoices, not support tickets.",
      "costPerDocument": 0.1
    },
    "emailParsing": {
      "parseEmailBody": true,
      "mergeEmailAttachments": true,
      "includeEmailSubjectBody": true,
      "attachmentFileTypes": [
        "string"
      ],
      "senderFilter": {
        "mode": "disabled",
        "rules": [
          {
            "type": "email",
            "value": "contact@parser.example"
          },
          {
            "type": "domain",
            "value": "example.com"
          }
        ]
      }
    },
    "parsePages": "string"
  },
  "createdAt": "2026-01-23T18:11:47.319Z",
  "updatedAt": "2026-01-23T18:12:29.860Z",
  "counts": {
    "totalDocuments": 128,
    "folders": 4
  }
}

{
  "error": true,
  "message": "Parser ID mismatch"
}