Resources
Filings
Every Filings endpoint, with the scope it enforces, the body it takes, a response you can read, and the refusals it can return.
Read the French affichage environnemental state.
/organizations/{organization}/passports/{id}/affichage- Scope
- passports:read
Idempotency-Key- Not accepted
- Returns
- 200
Path parameters
organizationstringRequiredThe organization this request acts for. The credential must hold a grant for it.
idstringRequiredThe identifier of the resource. Treat it as an opaque string.
Errors
Every refusal this endpoint can return, with the status it arrives with.
curl "https://passportcraft.com/api/v1/organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/passports/2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41/affichage" \
-H "Authorization: Bearer $PASSPORTCRAFT_API_KEY"{
"object": "affichage",
"name": "organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/passports/2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41/affichage",
"organization_id": "8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2",
"passport_id": "2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41",
"livemode": true,
"status": "not_filed",
"filed_at": null,
"portal_gtin": null,
"portal_score": null,
"filing_available": false,
"blockers": [
"delegation_required"
],
"delegation_status": "pending"
}GET /organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/passports/2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41/affichage
File the French affichage environnemental declaration.
/organizations/{organization}/passports/{id}/affichage- Scope
- filings:write
Idempotency-Key- Accepted
- Returns
- 200
Path parameters
organizationstringRequiredThe organization this request acts for. The credential must hold a grant for it.
idstringRequiredThe identifier of the resource. Treat it as an opaque string.
Errors
Every refusal this endpoint can return, with the status it arrives with.
- 403attestation_required
- 500configuration_error
- 403delegation_required
- 503entitlement_unavailable
- 422gtin_required
- 409idempotency_conflict
- 403insufficient_scope
- 500internal_error
- 401invalid_key
- 400invalid_request
- 401key_expired
- 401key_revoked
- 401key_rotated
- 400mode_mismatch
- 402no_subscription
- 404organization_not_found_or_not_granted
- 413payload_too_large
- 402payment_overdue
- 502portal_unavailable
- 429rate_limited
- 404resource_not_found
- 403test_mode_refused
- 415unsupported_media_type
- 422validation_failed
- 400wildcard_not_supported
- 409wrong_status
curl "https://passportcraft.com/api/v1/organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/passports/2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41/affichage" \
-X POST \
-H "Authorization: Bearer $PASSPORTCRAFT_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"{
"object": "affichage",
"name": "organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/passports/2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41/affichage",
"organization_id": "8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2",
"passport_id": "2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41",
"livemode": true,
"changed": true,
"unchanged_reason": null,
"status": "filed",
"filed_at": "2026-08-02T09:04:51.226Z",
"portal_gtin": "03453120000011",
"portal_score": 412,
"standardized_score": 412,
"durability": 1.05,
"official_label_url": "https://affichage-environnemental.ecobalyse.beta.gouv.fr/api/image?type=gtin>in=03453120000011&v=1785661491226",
"ecobalyse_version": "v7.0.0",
"declared_score": 412,
"free_offer": false
}POST /organizations/8f14e45f-ceea-467a-9a5f-8dc7d9c6a1b2/passports/2c1f9e07-3b4d-4a18-9f6c-5e0a7b8d3c41/affichage