utility_bill

Facture de services

Facture d'électricité, de gaz, d'eau, d'internet ou de téléphone de tout pays, utilisée comme justificatif de domicile : fournisseur, titulaire, adresse de fourniture, PDL/CUPS, période et montant.

Catégorie: Justificatif de domicile
Pays: International
Champs extraits: 16 champs
Coût: 1 crédit

utility_billspecimen

Supplier
Supplier tax id
Service type
Nom du titulaire
N° d'identité du titulaire
Supply address
Postal code
Country
Cups

Ce qui est contrôlé

Identifiants nationaux. Clé de contrôle ou format officiel du numéro (NIR, NIF, CPF, CURP…).postal_code
Code postal. Format du code postal du pays.
Titulaire. Nom, numéro ou date de naissance correspondent à l'attendu.
Ancienneté. Délivré il y a moins de N jours.

Champs extraits

Suppliersupplier
Supplier tax idsupplier_tax_id
Service typeservice_type
Nom du titulaireholder_name
N° d'identité du titulaireholder_id
Supply addresssupply_address
Postal codepostal_code
Countrycountry
Cupscups
Contract numbercontract_number
Invoice numberinvoice_number
Date de délivranceissue_date
Period startperiod_start
Period endperiod_end
Montantamount
Devisecurrency

Exemple de requête

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "utility_bill",
    "checks": {
      "max_age_days": 90,
      "holder": {
        "full_name": "Carmen Especimen Ruiz"
      }
    },
    "storage": "none"
  }'

Exemple de réponse

Données fictives. Réponse abrégée.

200 OK · application/json

{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "utility_bill",
    "label": "Facture de services",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "utility_bill"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "Le document est : Facture de services."
      }
    ]
  },
  "fields": {
    "supplier": {
      "value": "ESPECIMEN ENERGÍA S.A.",
      "confidence": 0.99,
      "validated": true
    },
    "supplier_tax_id": {
      "value": "A12345674",
      "confidence": 0.98,
      "validated": null
    },
    "service_type": {
      "value": "electricidad",
      "confidence": 0.97,
      "validated": null
    },
    "holder_name": {
      "value": "JUAN ESPAÑOL ESPAÑOL",
      "confidence": 0.96,
      "validated": null
    },
    "holder_id": {
      "value": "99999999R",
      "confidence": 0.99,
      "validated": null
    },
    "supply_address": {
      "value": "C/ MAYOR 1, 3º A, MADRID",
      "confidence": 0.98,
      "validated": null
    },
    "postal_code": {
      "value": "28013",
      "confidence": 0.97,
      "validated": null
    },
    "country": {
      "value": "ESP",
      "confidence": 0.96,
      "validated": null
    },
    "cups": {
      "value": "ES0021000000000000AA",
      "confidence": 0.99,
      "validated": null
    },
    "contract_number": {
      "value": "123456789",
      "confidence": 0.98,
      "validated": null
    },
    "invoice_number": {
      "value": "FE26-000123",
      "confidence": 0.97,
      "validated": null
    },
    "issue_date": {
      "value": "2026-09-05",
      "confidence": 0.96,
      "validated": null
    },
    "period_start": {
      "value": "2026-08-01",
      "confidence": 0.99,
      "validated": null
    },
    "period_end": {
      "value": "2026-08-31",
      "confidence": 0.98,
      "validated": null
    },
    "amount": {
      "value": 68.42,
      "confidence": 0.97,
      "validated": null
    },
    "currency": {
      "value": "EUR",
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "id_number",
      "passed": true,
      "message": "id_number"
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

Constaia prouve-t-il que le document est authentique ?

Non. Il contrôle le type, la cohérence des données et vos règles, et signale des indices comme une possible retouche ou une photo d'écran. Cela ne prouve pas l'authenticité.

Une copie du document est-elle conservée ?

Non, sauf si vous le demandez. Avec storage "none" (par défaut), le fichier est supprimé à la fin de l'analyse.

Autres documents

Et pour valoir ce que de droit…

Créez votre compte, copiez la clé de test et validez votre premier document en cinq minutes.

Créer un compte gratuit Parler à l'équipe commerciale