Skip to content
Constaia
sports_license

Sports federation licence

Check that the licence is valid on the event date and belongs to the athlete.

Category
Sport
Country
International
Fields it extracts
7 fields
Cost
1 credit
sports_licensespecimen
Holder name
Holder ID number
Federation
Licence number
Season
Category
Valid until

Every federation has its own format. Constaia extracts the federation, number, season, category and validity, and checks the holder and that the licence is valid on the date you choose.

  • Useful for open events where the discount depends on holding a licence.

What it checks

  • NIF/NIE check letter. The check character is recomputed (mod 23).
  • Holder. Name, number or date of birth match what you expect.
  • Validity. Not expired on the reference date.

Fields it extracts

  • Holder nameholder_name
  • Holder ID numberholder_id
  • Federationfederation
  • Licence numberlicense_number
  • Seasonseason
  • Categorycategory
  • Valid untilvalid_until

Where it is used

Sample request

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "sports_license",
    "checks": {
      "not_expired": true,
      "reference_date": "2027-03-14",
      "holder": {
        "full_name": "Laura Martín Ruiz"
      }
    },
    "storage": "none"
  }'

Sample response

Fictitious data. Shortened response.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "sports_license",
    "label": "Sports federation licence",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "sports_license"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: Sports federation licence."
      }
    ]
  },
  "fields": {
    "holder_name": {
      "value": "LAURA MARTÍN RUIZ",
      "confidence": 0.99,
      "validated": true
    },
    "holder_id": {
      "value": "87654321X",
      "confidence": 0.98,
      "validated": null
    },
    "federation": {
      "value": "Federación de Montaña",
      "confidence": 0.97,
      "validated": null
    },
    "license_number": {
      "value": "A-2027-004512",
      "confidence": 0.96,
      "validated": null
    },
    "season": {
      "value": "2027",
      "confidence": 0.99,
      "validated": null
    },
    "category": {
      "value": "Senior",
      "confidence": 0.98,
      "validated": null
    },
    "valid_until": {
      "value": "2027-12-31",
      "confidence": 0.97,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "holder_match",
      "passed": true,
      "message": "The holder matches."
    },
    {
      "code": "not_expired",
      "passed": true,
      "message": "Valid on the reference date."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

Does Constaia prove that the document is authentic?

No. It checks the type, the consistency of the data and your rules, and flags signals such as a possible edit or a photo of a screen. That does not prove authenticity.

Is a copy of the document kept?

Only if it needs review: it is then kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it is deleted as soon as the analysis ends. You can choose never to keep it.

Other documents

And for the record…

Create your free account and validate your first document in five minutes. No card required.