Aller au contenu
Constaia
tax_residence_certificate

Certificat de résidence fiscale

Certificat de résidence fiscale de tout pays aux fins des conventions fiscales (y compris le formulaire IRS 6166).

Catégorie
Fiscalité
Pays
International
Champs extraits
8 champs
Coût
1 crédit
tax_residence_certificatespecimen
Nom du titulaire
N° d'identité du titulaire
Date de délivrance
Country
Année fiscale
Treaty
Issuing authority
Verification code

Ce qui est contrôlé

  • Titulaire. Nom, numéro ou date de naissance correspondent à l'attendu.
  • Ancienneté. Délivré il y a moins de N jours.

Champs extraits

  • Nom du titulaireholder_name
  • N° d'identité du titulaireholder_id
  • Date de délivranceissue_date
  • Countrycountry
  • Année fiscaletax_year
  • Treatytreaty
  • Issuing authorityissuing_authority
  • Verification codeverification_code

Exemple de requête

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "tax_residence_certificate",
    "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": "tax_residence_certificate",
    "label": "Certificat de résidence fiscale",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "tax_residence_certificate"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "Le document est : Certificat de résidence fiscale."
      }
    ]
  },
  "fields": {
    "holder_name": {
      "value": "ESPECIMEN",
      "confidence": 0.99,
      "validated": true
    },
    "holder_id": {
      "value": "ESPECIMEN",
      "confidence": 0.98,
      "validated": null
    },
    "issue_date": {
      "value": "2026-09-01",
      "confidence": 0.97,
      "validated": null
    },
    "country": {
      "value": "ESPECIMEN",
      "confidence": 0.96,
      "validated": null
    },
    "tax_year": {
      "value": 1,
      "confidence": 0.99,
      "validated": null
    },
    "treaty": {
      "value": "ESPECIMEN",
      "confidence": 0.98,
      "validated": null
    },
    "issuing_authority": {
      "value": "ESPECIMEN",
      "confidence": 0.97,
      "validated": null
    },
    "verification_code": {
      "value": "ESPECIMEN",
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [],
  "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.