Skip to main content
POST
Submit a case
Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.
A kind paid as a service answers 402 with the payment_url where the owner pays first.

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.

Path Parameters

company_id
string<uuid>
required

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

case_id
string<uuid>
required

Response

The submitted case.

id
string<uuid>
required
kind
enum<string>
required

modelo: prepare and file one AEAT form for one period (details model, period); an empresa cannot ask for the 130, 131 or 100. alta: register an autónomo with the AEAT and the Social Security (details start_date, activity). renta: an autónomo's annual income tax return, modelo 100 (details year, joint). constitucion_sl: incorporate an S.L. or S.L.U., paid once by the owner before Melso starts. More kinds are added over time; read them from List case kinds.

Available options:
modelo,
alta,
renta,
constitucion_sl
status
enum<string>
required

draft: not sent yet. review: Melso's professionals are working on it. info: they asked the company for something (information_request). approval: a draft waits for the company's approval. filing: approved, being filed. done: filed, with the administration's external_reference. cancelled: withdrawn before filing.

Available options:
draft,
review,
info,
approval,
filing,
done,
cancelled
created_at
string<date-time>
required
deadline
string<date> | null
current_version
integer | null
approved_version
integer | null
payment_url
string<uri> | null

Where the owner pays a service kind before Melso starts.

information_request
object | null

What the professionals need from the company, with the items to answer.

messages
object[]
documents
object[]

The professionals' drafts, the company's documents and the filing receipts.

external_reference
string | null

The administration's reference for what was filed. Always present once done.

completed_on
string<date> | null
updated_at
string<date-time>