API reference

Every endpoint, every field, every status code — rendered directly from the fiscaliacore OpenAPI 3.1 spec.

Interactive playground (Swagger UI)

Open the playground directly: api.fiscaliacore.com/swagger-ui.html.

Direct spec download

• OpenAPI 3.1 JSON: api.fiscaliacore.com/v3/api-docs
• OpenAPI 3.1 YAML: api.fiscaliacore.com/v3/api-docs.yaml
• Versioned snapshot (from main): docs/api/openapi.json on GitHub

Generate a typed client:

# Node / TypeScript — openapi-typescript-codegen
npx openapi-typescript-codegen \
  --input https://api.fiscaliacore.com/v3/api-docs \
  --output ./src/fiscaliacore-client \
  --client fetch

# Java — openapi-generator
npx @openapitools/openapi-generator-cli generate \
  -i https://api.fiscaliacore.com/v3/api-docs \
  -g java \
  -o ./fiscaliacore-client-java

Endpoint summary

Method	Path	Tag	Status
POST	/api/v1/sessions	Sessions	✅ Live
DELETE	/api/v1/sessions/current	Sessions	✅ Live
POST	/api/v1/acecf/issue	ACECF	✅ Live
POST	/api/v1/ecf/issue-stateless	ECF	✅ Live (flag-gated — see below)
POST	/api/v1/ecf/issue	ECF	🔶 Legacy stateful — replaced in Phase 6
GET	/api/v1/status/{trackId}	Status	🔶 Phase 4
POST	/api/v1/ri/generate	Representación Impresa	🔶 Phase 4
/fe/* host-routed	Inbound	🔶 Phase 5

/api/v1/ecf/issue-stateless is the new stateless e-CF endpoint (Phase 3). Bearer-session auth, every business fact on the request body, no DB writes. Enable with dgii.ecf.stateless-issue.enabled=true on the server. In Phase 6 it takes over at /api/v1/ecf/issue and the legacy stateful variant is removed.

See the refactor phase plan for timing.