curl --request GET \
--url https://api.melso.ai/v1/companies/{company_id}/notifications/{notification_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.melso.ai/v1/companies/{company_id}/notifications/{notification_id}"
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}/notifications/{notification_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"administration": "aeat",
"subject": "<string>",
"made_available_at": "2023-11-07T05:31:56Z",
"status": "available",
"channel": "dehu",
"procedure": "<string>",
"accessed_at": "2023-11-07T05:31:56Z",
"deemed_received_on": "2023-12-25",
"summary": "<string>",
"response_deadline": "2023-12-25",
"documents": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"filename": "<string>",
"content_type": "<string>",
"size_bytes": 123,
"url": "<string>"
}
],
"case_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "invalid token",
"code": "unauthorized",
"request_id": "req_01JAB3K9X2"
}{
"error": "invoice not found",
"code": "not_found",
"request_id": "req_01JAB3K9X2"
}Get an administration notification
Returns one notification with Melso’s summary, the deadline it starts and the case Melso opened to answer it, if any.
curl --request GET \
--url https://api.melso.ai/v1/companies/{company_id}/notifications/{notification_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.melso.ai/v1/companies/{company_id}/notifications/{notification_id}"
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}/notifications/{notification_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"administration": "aeat",
"subject": "<string>",
"made_available_at": "2023-11-07T05:31:56Z",
"status": "available",
"channel": "dehu",
"procedure": "<string>",
"accessed_at": "2023-11-07T05:31:56Z",
"deemed_received_on": "2023-12-25",
"summary": "<string>",
"response_deadline": "2023-12-25",
"documents": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"filename": "<string>",
"content_type": "<string>",
"size_bytes": 123,
"url": "<string>"
}
],
"case_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"error": "invalid token",
"code": "unauthorized",
"request_id": "req_01JAB3K9X2"
}{
"error": "invoice not found",
"code": "not_found",
"request_id": "req_01JAB3K9X2"
}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 notification.
The administration a form, mandate or notification belongs to. The foral treasuries of Álava, Bizkaia, Gipuzkoa and Navarra replace the AEAT where they apply.
aeat, tgss, sepe, alava, bizkaia, gipuzkoa, navarra, canarias, ceuta, melilla, registro_mercantil available, accessed, deemed_received Where it was made available.
dehu, aeat_sede, tgss_sede, dgt_dev The procedure it belongs to, such as a requerimiento or a propuesta de liquidación.
When it counts as received, on access or ten calendar days after being made available.
Melso's plain-language summary of what it asks and by when.
Show child attributes
Show child attributes
The case Melso opened to answer it.