Skip to main content
GET
Get an income
Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.

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.

income_id
string<uuid>
required

Response

The income.

customer_name
string
required
Maximum string length: 200
issue_date
string<date>
required
vat_lines
object[]
required

One line per VAT rate. A line with a decimal rate is recargo de equivalencia.

Required array length: 1 - 10 elements
id
string<uuid>
required
subtotal
string
required

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

vat_amount
string
required

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

total
string
required

subtotal plus vat_amount; IRPF withheld is not subtracted.

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

version
integer
required
created_at
string<date-time>
required
customer_tax_id
string
Maximum string length: 32
customer_country
string
default:ES
document_number
string

Unique in the company.

Maximum string length: 100
operation_date
string<date>
description
string
Maximum string length: 200
vat_treatment
enum<string>
default:taxable
Available options:
taxable,
exempt,
reverse_charge,
not_subject
irpf_rate
string

A decimal number as a string, such as "21" or "0.5".

Pattern: ^-?[0-9]{1,10}(\.[0-9]{1,6})?$
irpf_amount
string

An amount in euros as a decimal string with two decimals, such as "121.00".

Pattern: ^-?[0-9]+\.[0-9]{2}$
Example:

"121.00"

file_id
string<uuid>
currency
string
exchange_rate
string | null
source
enum<string>
Available options:
upload,
whatsapp,
gmail,
import
review_reasons
string[]
updated_at
string<date-time>