Skip to main content
POST
Request a certificate
Preview. A contract we are building with design partners. It is not callable yet, and fields can still change. See Availability.
Melso obtains it under the company’s mandate; the certificate carries the administration’s CSV (código seguro de verificación) for anyone to verify it.

Authorizations

Authorization
string
header
required

Your partner secret key, mk_live_… for real companies or mk_test_… for test companies. Keep it on your servers. See Authentication.

Headers

Idempotency-Key
string

A unique key, such as a UUID, that makes a retried create safe. Reusing a key with a different body is refused.

Maximum string length: 255

Path Parameters

company_id
string<uuid>
required

The company's ID. Every company-scoped call works in exactly this company.

Body

application/json
type
enum<string>
required

aeat_tax_compliance: up to date with tax obligations. tgss_compliance: up to date with the Social Security. aeat_census_status: census situation. aeat_vat_registration: registration in the register of exporters and intra-community operators (ROI).

Available options:
aeat_tax_compliance,
tgss_compliance,
aeat_census_status,
aeat_vat_registration
purpose
string

Why it is needed, when the administration asks for it, such as public_procurement or subsidy.

Response

The request, pending until the administration issues it.

id
string<uuid>
required
type
enum<string>
required

aeat_tax_compliance: up to date with tax obligations. tgss_compliance: up to date with the Social Security. aeat_census_status: census situation. aeat_vat_registration: registration in the register of exporters and intra-community operators (ROI).

Available options:
aeat_tax_compliance,
tgss_compliance,
aeat_census_status,
aeat_vat_registration
status
enum<string>
required

negative: the administration issued it as not up to date; findings says why.

Available options:
pending,
issued,
negative,
failed
requested_at
string<date-time>
required
csv
string | null

The código seguro de verificación.

issued_at
string<date-time> | null
findings
string[]
document
object | null