Invoice status

Check network processing status.

POST/v1/einvoice/status

Overview

Check network processing status.

Use cases

Use `einvoice.status` when you need invoice status through the provider-neutral QuoAPI contract.

Authentication

Send a QuoAPI API key as `Authorization: Bearer gi_test_...` or an approved live key. Test and live environments are isolated.

Quick start

Send `POST` to `/v1/einvoice/status`. Start in the test environment and keep the request ID for support and tracing.

Request fields

- `reference` — string, required. - `country` — string, optional. Optional ISO 3166-1 alpha-2 routing context. - `currency` — string, optional. Optional ISO 4217 commercial context.

Response fields

The response envelope contains `data` validated against the canonical response schema and `request_id`. Response schema type: `object`.

Errors

Errors use `error.code`, `error.message`, `error.request_id` and structured `error.details`. Provider names, credentials, upstream URLs and raw upstream errors are not part of the public contract.

Webhooks

This capability does not emit a public webhook event.

Rate limits

Rate limits are enforced by API key, organization, plan, capability and environment. Responses include standard rate-limit headers and `Retry-After` when applicable.

Idempotency

Retryable write operations support QuoAPI idempotency semantics so a replay does not create duplicate billing or side effects.

Sandbox

The Playground uses deterministic safe sandbox behavior. Anonymous demos cannot perform purchases, registrations, messages or destructive actions.

Pricing

Usage is measured in `document` and priced in `document` units.

Async behavior

The operation returns through the normal request lifecycle.

Contract version

`1.3.0:einvoice.status` — schema checksum `f7a4669f44f4c1e9d21abab2a6ef4e0f5dac384ca4760229155f3f6999327286`.

Request schema

{
  "additionalProperties": false,
  "properties": {
    "country": {
      "description": "Optional ISO 3166-1 alpha-2 routing context.",
      "pattern": "^[A-Z]{2}$",
      "type": "string",
      "x-quoapi-hidden": true,
      "x-quoapi-widget": "country"
    },
    "currency": {
      "description": "Optional ISO 4217 commercial context.",
      "pattern": "^[A-Z]{3}$",
      "type": "string",
      "x-quoapi-hidden": true,
      "x-quoapi-widget": "currency"
    },
    "reference": {
      "default": "einv_demo_001",
      "title": "Reference",
      "type": "string",
      "x-quoapi-widget": "text"
    }
  },
  "required": [
    "reference"
  ],
  "type": "object"
}

Response schema

{
  "additionalProperties": true,
  "description": "Canonical QuoAPI response data for this capability.",
  "type": "object"
}

Example request

{
  "reference": "einv_demo_001"
}

Try in Playground

Code examples

curl

curl -X POST "https://api.quoapi.com/v1/einvoice/status" \
  -H "Authorization: Bearer $QUOAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"reference\": \"einv_demo_001\"}"

javascript

const response = await fetch("https://api.quoapi.com/v1/einvoice/status", {
  method: "POST",
  headers: {Authorization: `Bearer ${process.env.QUOAPI_API_KEY}`, "Content-Type": "application/json"},
  body: JSON.stringify({"reference": "einv_demo_001"})
});
const data = await response.json();

typescript

const response = await fetch("https://api.quoapi.com/v1/einvoice/status", {
  method: "POST",
  headers: {Authorization: `Bearer ${process.env.QUOAPI_API_KEY}`, "Content-Type": "application/json"},
  body: JSON.stringify({"reference": "einv_demo_001"})
});
const data = await response.json();

php

<?php
$ch = curl_init("https://api.quoapi.com/v1/einvoice/status");
curl_setopt_array($ch, [CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_HTTPHEADER => ["Authorization: Bearer ".getenv("QUOAPI_API_KEY"), "Content-Type: application/json"], CURLOPT_POSTFIELDS => "{\"reference\": \"einv_demo_001\"}", CURLOPT_RETURNTRANSFER => true]);
echo curl_exec($ch);

python

import os, requests
response = requests.request("POST", "https://api.quoapi.com/v1/einvoice/status", headers={"Authorization": "Bearer " + os.environ["QUOAPI_API_KEY"]}, json={'reference': 'einv_demo_001'})
print(response.json())

csharp

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("QUOAPI_API_KEY"));
var response = await client.PostAsJsonAsync("https://api.quoapi.com/v1/einvoice/status", {"reference": "einv_demo_001"});

java

var request = java.net.http.HttpRequest.newBuilder(java.net.URI.create("https://api.quoapi.com/v1/einvoice/status"))
  .header("Authorization", "Bearer " + System.getenv("QUOAPI_API_KEY"))
  .header("Content-Type", "application/json")
  .method("POST", java.net.http.HttpRequest.BodyPublishers.ofString("{\"reference\": \"einv_demo_001\"}")).build();

payload := strings.NewReader("{\"reference\": \"einv_demo_001\"}")
req, _ := http.NewRequest("POST", "https://api.quoapi.com/v1/einvoice/status", payload)
req.Header.Set("Authorization", "Bearer "+os.Getenv("QUOAPI_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)