api.invoket.com

{
  "properties": {
    "data": {
      "properties": {
        "company": {
          "description": "Minimal Sirene identity echo (name or natural person, active/ceased status) for cross-reading with /company/resolve; only for siren=/siret= input (absent for an explicit participant= lookup); when the SIREN is unknown to the Sirene stock it is stated in coverage.identity - never an error",
          "properties": {
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "natural_person": {
              "type": [
                "object",
                "null"
              ]
            },
            "status": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "status"
          ],
          "type": "object"
        },
        "coverage": {
          "description": "Honest coverage: 'directory_as_of' dates the ingested directory export and 'note' restates that reachability is a snapshot, not a live SMP lookup; 'identity' appears when the Sirene echo could not be served. Never a 5xx for staleness",
          "properties": {
            "directory_as_of": {
              "type": "string"
            },
            "identity": {
              "type": "string"
            },
            "note": {
              "type": "string"
            }
          },
          "required": [
            "directory_as_of",
            "note"
          ],
          "type": "object"
        },
        "participants": {
          "description": "Every directory registration matching the query - a French SIREN can appear under several identifiers: head-office SIRET (ICD 0009), bare SIREN (0002/0225) and CTC routing sub-addresses of the French 2026 e-invoicing reform. Each entry carries the full Peppol ID (scheme:value), declared names and registration date relayed verbatim (never corrected), and the accepted document_types: full Peppol identifier, declared display_name, and a derived short label ('invoice', 'credit-note'... - null when not derivable, never guessed)",
          "items": {
            "properties": {
              "country": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "document_types": {
                "items": {
                  "properties": {
                    "display_name": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "identifier": {
                      "type": "string"
                    },
                    "label": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "display_name",
                    "identifier",
                    "label"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "id": {
                "type": "string"
              },
              "names": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "registered_on": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "scheme": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "required": [
              "country",
              "document_types",
              "id",
              "names",
              "registered_on",
              "scheme",
              "value"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "reachable": {
          "description": "True when at least one participant identifier matches the query in the ingested directory export. False is a paid, useful answer: the company is not registered on Peppol as of the export date - dated by coverage.directory_as_of, never presented as a live SMP truth",
          "type": "boolean"
        }
      },
      "required": [
        "coverage",
        "participants",
        "reachable"
      ],
      "type": "object"
    },
    "provenance": {
      "properties": {
        "fetched_at": {
          "type": "string"
        },
        "freshness": {
          "properties": {
            "as_of": {
              "type": "string"
            },
            "kind": {
              "type": "string"
            }
          },
          "required": [
            "as_of",
            "kind"
          ],
          "type": "object"
        },
        "source": {
          "type": "string"
        }
      },
      "required": [
        "fetched_at",
        "freshness",
        "source"
      ],
      "type": "object"
    }
  },
  "required": [
    "data",
    "provenance"
  ],
  "type": "object"
}