captain-legal

List legal document types Captain.Legal can generate for a given country. Call this first to discover what's available and get accurate names, prices and legal coverage. Never assume a document type exists — always check here.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "language": {
      "type": "string",
      "minLength": 2,
      "maxLength": 5
    },
    "category": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "country"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the exact questions to ask the user for a given document type and country, with validation rules and legal constraints. You MUST use these questions verbatim as your source of truth for the interview — do not invent fields. Fields are ordered and may be conditional on previous answers.

{
  "type": "object",
  "properties": {
    "document_type": {
      "type": "string",
      "minLength": 1
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "language": {
      "type": "string",
      "minLength": 2,
      "maxLength": 5
    }
  },
  "required": [
    "document_type",
    "country"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Generate a draft of the document from the user's answers. Returns a free watermarked PDF preview and the exact price. Validates all answers against the encoded national rules first — if validation fails, you get structured errors to relay to the user. Also returns what is NOT covered by the automated checks: always relay the not_covered items to the user.

{
  "type": "object",
  "properties": {
    "document_type": {
      "type": "string",
      "minLength": 1
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "language": {
      "type": "string",
      "minLength": 2,
      "maxLength": 5
    },
    "answers": {
      "type": "object",
      "additionalProperties": {},
      "description": "Answers keyed by field id, exactly as returned by get_requirements"
    }
  },
  "required": [
    "document_type",
    "country",
    "answers"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Purchase the final document for a given draft. Returns a secure payment link to give to the user. After payment, the final PDF is emailed to the user within minutes. E-signature is not yet available.

{
  "type": "object",
  "properties": {
    "draft_id": {
      "type": "string",
      "minLength": 1
    },
    "customer_email": {
      "type": "string",
      "minLength": 3
    }
  },
  "required": [
    "draft_id",
    "customer_email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check the status of an order: payment and delivery. Requires the status_token returned by purchase_document.

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "minLength": 1
    },
    "status_token": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "order_id",
    "status_token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}