Get the fiscal profile
curl --request GET \
--url https://api.melso.ai/v1/companies/{company_id}/fiscal-profile \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.melso.ai/v1/companies/{company_id}/fiscal-profile"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.melso.ai/v1/companies/{company_id}/fiscal-profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"profile": {
"tax_id": "<string>",
"legal_name": "<string>",
"trade_name": "<string>",
"address": "<string>",
"postal_code": "<string>",
"city": "<string>",
"province": "<string>",
"tax_territory": "comun",
"vat_regime": "general",
"activity_type": "profesional",
"activity_description": "<string>",
"iae_code": "<string>",
"registration_status": "alta",
"registered_on": "<string>",
"irpf_method": "directa_simplificada",
"irpf_retention_rate": 50,
"eu_operator": true,
"vat_sii": true,
"vat_redeme": true,
"is_large_company": true,
"client_types": [
"es_business"
],
"invoice_series": "<string>",
"next_invoice_number": 500000000,
"iban": "<string>",
"tax_id_type": "dni"
},
"missing": [
"<string>"
],
"errors": {},
"deduced": {},
"invoice_missing": [
"<string>"
],
"tax_missing": [
"<string>"
]
}{
"error": "invalid token",
"code": "unauthorized",
"request_id": "req_01JAB3K9X2"
}{
"error": "invoice not found",
"code": "not_found",
"request_id": "req_01JAB3K9X2"
}Companies
Get the fiscal profile
Returns the company’s tax profile, and what is still missing to invoice (invoice_missing) and to calculate its returns (tax_missing).
GET
/
companies
/
{company_id}
/
fiscal-profile
Get the fiscal profile
curl --request GET \
--url https://api.melso.ai/v1/companies/{company_id}/fiscal-profile \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.melso.ai/v1/companies/{company_id}/fiscal-profile"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.melso.ai/v1/companies/{company_id}/fiscal-profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"profile": {
"tax_id": "<string>",
"legal_name": "<string>",
"trade_name": "<string>",
"address": "<string>",
"postal_code": "<string>",
"city": "<string>",
"province": "<string>",
"tax_territory": "comun",
"vat_regime": "general",
"activity_type": "profesional",
"activity_description": "<string>",
"iae_code": "<string>",
"registration_status": "alta",
"registered_on": "<string>",
"irpf_method": "directa_simplificada",
"irpf_retention_rate": 50,
"eu_operator": true,
"vat_sii": true,
"vat_redeme": true,
"is_large_company": true,
"client_types": [
"es_business"
],
"invoice_series": "<string>",
"next_invoice_number": 500000000,
"iban": "<string>",
"tax_id_type": "dni"
},
"missing": [
"<string>"
],
"errors": {},
"deduced": {},
"invoice_missing": [
"<string>"
],
"tax_missing": [
"<string>"
]
}{
"error": "invalid token",
"code": "unauthorized",
"request_id": "req_01JAB3K9X2"
}{
"error": "invoice not found",
"code": "not_found",
"request_id": "req_01JAB3K9X2"
}Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.
Authorizations
Your partner secret key, mk_live_… for real companies or mk_test_…
for test companies. Keep it on your servers. See
Authentication.
Path Parameters
The company's ID. Every company-scoped call works in exactly this company.
Response
The profile.
Show child attributes
Show child attributes
The fields not saved, each with the reason.
Show child attributes
Show child attributes
Fields Melso filled in from others, such as the territory from the postal code.
What is still needed to invoice.
What is still needed to calculate returns.