curl --request POST \
  --url https://api.melso.ai/v1/companies/{company_id}/tax-returns/{tax_return_id}/attested-approvals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "expected_version": 4,
  "approver": {
    "name": "Lucía Martín Pérez",
    "email": "lucia@example.com",
    "role": "owner",
    "external_user_id": "usr_8f2k1"
  },
  "evidence": {
    "approved_at": "2026-10-14T09:12:44Z",
    "ip_address": "203.0.113.24",
    "user_agent": "Mozilla/5.0",
    "shown_document_sha256": "9f2c4e0b7d1a3c5e8f6a2b4d0c1e3f5a7b9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e"
  }
}
'

import requests

url = "https://api.melso.ai/v1/companies/{company_id}/tax-returns/{tax_return_id}/attested-approvals"

payload = {
    "expected_version": 4,
    "approver": {
        "name": "Lucía Martín Pérez",
        "email": "lucia@example.com",
        "role": "owner",
        "external_user_id": "usr_8f2k1"
    },
    "evidence": {
        "approved_at": "2026-10-14T09:12:44Z",
        "ip_address": "203.0.113.24",
        "user_agent": "Mozilla/5.0",
        "shown_document_sha256": "9f2c4e0b7d1a3c5e8f6a2b4d0c1e3f5a7b9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    expected_version: 4,
    approver: {
      name: 'Lucía Martín Pérez',
      email: 'lucia@example.com',
      role: 'owner',
      external_user_id: 'usr_8f2k1'
    },
    evidence: {
      approved_at: '2026-10-14T09:12:44Z',
      ip_address: '203.0.113.24',
      user_agent: 'Mozilla/5.0',
      shown_document_sha256: '9f2c4e0b7d1a3c5e8f6a2b4d0c1e3f5a7b9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e'
    }
  })
};

fetch('https://api.melso.ai/v1/companies/{company_id}/tax-returns/{tax_return_id}/attested-approvals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "<string>",
  "model": "<string>",
  "period": "2026-Q3",
  "status": "draft",
  "is_estimate": true,
  "amount": "121.00",
  "version": 123,
  "approved_version": 123,
  "approved_at": "2023-11-07T05:31:56Z",
  "deadline": "2023-12-25",
  "direct_debit_deadline": "2023-12-25",
  "boxes": [
    {
      "box": "<string>",
      "key": "<string>",
      "amount": "121.00"
    }
  ],
  "records": [
    {
      "tax_id": "<string>",
      "name": "<string>",
      "country": "<string>",
      "key": "<string>",
      "amount": "121.00",
      "withheld": "121.00",
      "quarters": [
        "121.00"
      ],
      "missing": [
        "tax_id"
      ]
    }
  ],
  "review": [
    "missing_tax_id"
  ],
  "unconfirmed_expenses": 123,
  "filed_at": "2023-11-07T05:31:56Z",
  "filing": {
    "filed_at": "2023-11-07T05:31:56Z",
    "reference": "<string>",
    "csv": "<string>",
    "receipt": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "filename": "<string>",
      "content_type": "<string>",
      "size_bytes": 123,
      "url": "<string>"
    },
    "filed_by": "melso"
  },
  "recalculated": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "error": "lines[0].vat_rate must be 21, 10, 4 or 0",
  "code": "invalid_invoice",
  "request_id": "req_01JAB3K9X2"
}

{
  "error": "invalid token",
  "code": "unauthorized",
  "request_id": "req_01JAB3K9X2"
}

{
  "error": "Review and approve in the authenticated web application",
  "code": "person_required",
  "request_id": "req_01JAB3K9X2"
}

{
  "error": "The tax return changed or is not ready for approval",
  "code": "version_conflict",
  "request_id": "req_01JAB3K9X2"
}