Transport Documents

Retrieve a transport document

Retrieve a transport document (DeCA) by its id, with parties, vehicle, shipments, goods, every version (author, reason, sha256), public URL and lifecycle dates.

Shipments built from a delivery note report source_changed/source_changes or source_missing.
Another company's document returns 404 transport_document_not_found.

get/companies/{company}/transport-documents/{transport_document}

Request

Base URL: https://api.factuarea.com/v1
URL: https://api.factuarea.com/v1/companies/{company}/transport-documents/{transport_document}
Auth: one of:
- HTTP bearer
- API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

transport_documentstring uuid required

Public identifier (UUID v7) of the transport control document (DeCA).

Headers

Factuarea-Versionstring date

Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

Example response

{
  "data": {
    "number": "DC-2026-007",
    "status": "issued",
    "shipper": {
      "name": "Transportes Pérez SL",
      "tax_id": "B12345674",
      "tax_id_country": "ES",
      "address": {
        "line": "Calle de la Industria 14",
        "postal_code": "28901",
        "city": "Getafe",
        "province": "Madrid",
        "country": "ES",
        "name": "Nave Getafe"
      }
    },
    "carrier": {
      "name": "Transportes Pérez SL",
      "tax_id": "B12345674",
      "tax_id_country": "ES",
      "address": {
        "line": "Calle de la Industria 14",
        "postal_code": "28901",
        "city": "Getafe",
        "province": "Madrid",
        "country": "ES",
        "name": "Nave Getafe"
      }
    },
    "vehicle": {
      "tractor_plate": "1234BCD",
      "tractor_plate_country": "ES",
      "trailer_plate": "R1234BCD",
      "trailer_plate_country": "ES"
    },
    "shipments": [
      {
        "origin": {
          "line": "Calle de la Industria 14",
          "postal_code": "28901",
          "city": "Getafe",
          "province": "Madrid",
          "country": "ES",
          "name": "Nave Getafe"
        },
        "destination": {
          "line": "Calle de la Industria 14",
          "postal_code": "28901",
          "city": "Getafe",
          "province": "Madrid",
          "country": "ES",
          "name": "Nave Getafe"
        },
        "goods": [
          {
            "description": "Aceite de oliva virgen extra 5 L",
            "quantity": "12.0000",
            "unit": "garrafa",
            "gross_weight_kg": "4.8500"
          }
        ],
        "declared_measure": {
          "weight_kg": "1250.5000"
        },
        "source_changes": [
          {
            "field": "vehicle.tractor_plate",
            "previous": "1234BCD",
            "current": "5678FGH"
          }
        ]
      }
    ],
    "versions": [
      {
        "number": 2,
        "reason": "Avería de la tractora",
        "changes": [
          {
            "field": "vehicle.tractor_plate",
            "previous": "1234BCD",
            "current": "5678FGH"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.