Latea API reference

Every action the Latea dashboard performs is available over a JSON HTTP API, authenticated with a key you issue yourself. This page documents 72 operations across 14 resource groups, generated from the same OpenAPI description the server validates incoming requests against.

Download the OpenAPI spec (JSON)

Getting started

Base URL

Every path below is relative to:

https://latea.strangeskills.com/api

Authentication

Create a key in the dashboard under /dashboard/latea/settings/apikeys, then send it in the apikey header on every request:

curl 'https://latea.strangeskills.com/api/users/apikeys' \
  -H 'apikey: YOUR_API_KEY'

Three properties of a key matter before you build against it:

A key belongs to one organization. Every request is scoped to that organization's data. There is no cross-organization or account-wide key.
A key belongs to one product. A Latea key is refused with app_not_allowed on another product's endpoints, and with app_not_enabled if the organization has not enabled Latea.
A key can be read-only. A read-only key answers GET, HEAD and OPTIONS and returns read_only_key on anything that writes — the safer key to hand to a script or an assistant.

The dashboard authenticates with a session cookie instead, which is why operations below list both schemes. For an integration, the API key is the one you want.

Errors

Errors come back as JSON, with the HTTP status repeated in the body:

{ "statusCode": 403, "code": "read_only_key", "message": "Read-only API key" }

Status	Code	Meaning
`400`	`validation`	The request body or query does not match the schema.
`401`	`unauthorized`	No API key or session, or the key does not exist.
`403`	`forbidden`	The key is valid but not allowed to perform this operation.
`403`	`read_only_key`	A read-only key attempted a write.
`403`	`app_not_enabled`	The organization does not have this product enabled.
`403`	`app_not_allowed`	The key belongs to a different product.
`404`	`not_found`	No such route, or no such record in this organization.
`500`	`internal`	Unexpected server error.

Model Context Protocol

The same key authenticates an MCP endpoint, so an assistant can drive Latea directly instead of composing HTTP calls. It speaks Streamable HTTP and offers the operations below as tools, filtered to what the key is allowed to do:

https://latea.strangeskills.com/mcp
Authorization: Bearer YOUR_API_KEY

Reference

Search endpoints

Latea

Customer subscriptions

get`/subscriptions/entity`

Get entity subscriptions

Parameters

Name	In	Type	Required
`entityId`	query	`integer`	no
`planId`	query	`integer`	no
`status`	query	`string`	no
`search`	query	`string`	no

Responses

Status	Description	Body
`200`	List of entity subscriptions	`EntitySubscription[]`

Example

curl -X GET 'https://latea.strangeskills.com/api/subscriptions/entity' \
  -H 'apikey: YOUR_API_KEY'

post`/subscriptions/entity`

Create an entity subscription

Request body

application/json — { planId, entityId }

Responses

Status	Description	Body
`201`	Created subscription	`{ id, stripeSubscriptionId, clientSecret, status }`

Example

curl -X POST 'https://latea.strangeskills.com/api/subscriptions/entity' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

get`/subscriptions/entity/{id}`

Get an entity subscription

Parameters

Name	In	Type	Required
`id`	path	`integer`	yes

Responses

Status	Description	Body
`200`	Entity subscription	`EntitySubscription`

Example

curl -X GET 'https://latea.strangeskills.com/api/subscriptions/entity/{id}' \
  -H 'apikey: YOUR_API_KEY'

post`/subscriptions/entity/{id}/cancel`

Cancel an entity subscription

Parameters

Name	In	Type	Required
`id`	path	`integer`	yes

Responses

Status	Description	Body
`204`	Subscription cancelled

Example

curl -X POST 'https://latea.strangeskills.com/api/subscriptions/entity/{id}/cancel' \
  -H 'apikey: YOUR_API_KEY'

post`/subscriptions/entity/{id}/pause`

Pause an entity subscription

Parameters

Name	In	Type	Required
`id`	path	`integer`	yes

Responses

Status	Description	Body
`204`	Subscription paused

Example

curl -X POST 'https://latea.strangeskills.com/api/subscriptions/entity/{id}/pause' \
  -H 'apikey: YOUR_API_KEY'

post`/subscriptions/entity/{id}/resume`

Resume an entity subscription

Parameters

Name	In	Type	Required
`id`	path	`integer`	yes

Responses

Status	Description	Body
`204`	Subscription resumed

Example

curl -X POST 'https://latea.strangeskills.com/api/subscriptions/entity/{id}/resume' \
  -H 'apikey: YOUR_API_KEY'

Documents

get`/latea/documents`

Get documents

Parameters

Name	In	Type	Required
`field`	query	`string`	yes
`order`	query	`string`	yes
`offset`	query	`number`	yes
`limit`	query	`number`	yes
`search`	query	`string`	no
`startDate`	query	`string`	no
`endDate`	query	`string`	no
`documentType`	query	`string`	no
`year`	query	`number`	no
`format`	query	`string`	no

Responses

Status	Description	Body
`200`	Document meta information.	`{ list, count }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/documents' \
  -H 'apikey: YOUR_API_KEY'

post`/latea/documents`

Put document

Request body

application/json — { reference, uniqueExternalRef, entityId, entityName, date, dueDate, duplicatedDate, discountPercentage, entityTaxNumber, address, serieId, serieName, documentType, taxExemptionId, observations, movementStartDate, movementEndDate, fromAddress, toAddress, lines }

Responses

Status	Description	Body
`201`	Document information.	`Document`
`default`	Error	`{ statusCode, code, message, data }`

Example

curl -X POST 'https://latea.strangeskills.com/api/latea/documents' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

post`/latea/documents/at/communicate`

Communicate document to AT

Request body

application/json — { id, serieId }

Responses

Status	Description	Body
`204`	Document communicated.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/latea/documents/at/communicate' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

put`/latea/documents/cancel`

Cancel document

Request body

application/json — { id, serieId, cancelledMotive }

Responses

Status	Description	Body
`204`	Document cancelled.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/latea/documents/cancel' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

get`/latea/documents/document/{id}/serie/{serieId}`

Get document

Parameters

Name	In	Type	Required
`id`	path	`number`	yes
`serieId`	path	`number`	yes
`format`	query	`string`	no
`mode`	query	`string`	no
`template`	query	`number`	no
`originalOnly`	query	`boolean`	no

Responses

Status	Description	Body
`200`	Document data.	`string`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/documents/document/{id}/serie/{serieId}' \
  -H 'apikey: YOUR_API_KEY'

get`/latea/documents/summary`

Get document summary

Responses

Status	Description	Body
`200`	Document summary information.	`{ invoiced, totalInvoicedCurrentYear, totalInvoicedCurrentMonth, totalInvoicedToday }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/documents/summary' \
  -H 'apikey: YOUR_API_KEY'

Entities

get`/latea/entities`

Get entities

Parameters

Name	In	Type	Required
`field`	query	`string`	yes
`order`	query	`string`	yes
`offset`	query	`number`	yes
`limit`	query	`number`	yes
`search`	query	`string`	no

Responses

Status	Description	Body
`200`	Entity information.	`{ list, count }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/entities' \
  -H 'apikey: YOUR_API_KEY'

post`/latea/entities`

Put entity

Request body

application/json — { name, taxNumber, email, telephone, mobile, type }

Responses

Status	Description	Body
`201`	Entity information.	`Entity`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/latea/entities' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

put`/latea/entities`

Update entity

Request body

application/json — object

Responses

Status	Description	Body
`200`	Entity information.	`Entity`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/latea/entities' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

post`/latea/entities/address`

Put entity address

Request body

application/json — { addressDetail, postalCode, city, country }

Responses

Status	Description	Body
`201`	Entity address information.	`Address`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/latea/entities/address' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

put`/latea/entities/address`

Update entity address

Request body

application/json — { id, addressDetail, postalCode, city, country }

Responses

Status	Description	Body
`200`	Entity address information.	`Address`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/latea/entities/address' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

delete`/latea/entities/address/entity/{entityId}/id/{id}`

Delete entity address

Parameters

Name	In	Type	Required
`entityId`	path	`number`	yes
`id`	path	`number`	yes

Responses

Status	Description	Body
`204`	Success
`default`	Error	`{ statusCode, code, message }`

Example

curl -X DELETE 'https://latea.strangeskills.com/api/latea/entities/address/entity/{entityId}/id/{id}' \
  -H 'apikey: YOUR_API_KEY'

get`/latea/entities/id/{id}`

Get entity

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`200`	Entity information.	`Entity`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/entities/id/{id}' \
  -H 'apikey: YOUR_API_KEY'

delete`/latea/entities/id/{id}`

Delete entity

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`204`	Success.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X DELETE 'https://latea.strangeskills.com/api/latea/entities/id/{id}' \
  -H 'apikey: YOUR_API_KEY'

get`/latea/entities/id/{id}/addresses`

Get entity addresses

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`200`	Entity addresses information.	`{ list, count }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/entities/id/{id}/addresses' \
  -H 'apikey: YOUR_API_KEY'

Exports

get`/latea/exports/saft/{year}`

Export a year's SAFT

Parameters

Name	In	Type	Required
`year`	path	`number`	yes

Responses

Status	Description	Body
`200`	Saft.	`string`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/exports/saft/{year}' \
  -H 'apikey: YOUR_API_KEY'

get`/latea/exports/saft/{year}/{month}`

Export SAFT

Parameters

Name	In	Type	Required
`year`	path	`number`	yes
`month`	path	`number`	yes

Responses

Status	Description	Body
`200`	Saft.	`string`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/exports/saft/{year}/{month}' \
  -H 'apikey: YOUR_API_KEY'

Products

get`/latea/products`

Get products

Parameters

Name	In	Type	Required
`field`	query	`string`	yes
`order`	query	`string`	yes
`offset`	query	`number`	yes
`limit`	query	`number`	yes
`search`	query	`string`	no

Responses

Status	Description	Body
`200`	Product meta information.	`{ list, count }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/products' \
  -H 'apikey: YOUR_API_KEY'

post`/latea/products`

Put product

Request body

application/json — { reference, description, taxId, type, controlStock }

Responses

Status	Description	Body
`201`	Product information.	`Product`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/latea/products' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

put`/latea/products`

Update product

Request body

application/json — { id, reference, description, taxId, type, controlStock }

Responses

Status	Description	Body
`200`	Product information.	`Product`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/latea/products' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

get`/latea/products/forline`

Get products for line

Parameters

Name	In	Type	Required
`field`	query	`string`	yes
`order`	query	`string`	yes
`offset`	query	`number`	yes
`limit`	query	`number`	yes
`search`	query	`string`	no

Responses

Status	Description	Body
`200`	Product line information.	`{ list, count }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/products/forline' \
  -H 'apikey: YOUR_API_KEY'

get`/latea/products/id/{id}`

Get product

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`200`	Product information.	`Product`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/products/id/{id}' \
  -H 'apikey: YOUR_API_KEY'

delete`/latea/products/id/{id}`

Delete product

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`204`	Success
`default`	Error	`{ statusCode, code, message }`

Example

curl -X DELETE 'https://latea.strangeskills.com/api/latea/products/id/{id}' \
  -H 'apikey: YOUR_API_KEY'

post`/latea/products/info`

Get info for products

Request body

application/json — { productIds }

Responses

Status	Description	Body
`200`	Product information.	`{ productId, reference, type, controlStock, stock }[]`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/latea/products/info' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Regions

get`/latea/regions`

Get regions

Responses

Status	Description	Body
`200`	Region information.	`{ list, count }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/regions' \
  -H 'apikey: YOUR_API_KEY'

Series

get`/latea/series`

Get series

Parameters

Name	In	Type	Required
`active`	query	`boolean`	no
`documentType`	query	`string`	no

Responses

Status	Description	Body
`200`	Serie meta information.	`{ list, count }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/series' \
  -H 'apikey: YOUR_API_KEY'

post`/latea/series`

Create serie

Request body

application/json — { name, documentType, manual, duplicated, atcud, active }

Responses

Status	Description	Body
`201`	Serie information.	`Serie`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/latea/series' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

put`/latea/series`

Update serie

Request body

application/json — { id, active }

Responses

Status	Description	Body
`200`	Serie information.	`Serie`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/latea/series' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

delete`/latea/series/id/{id}`

Delete serie

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`204`	Success
`default`	Error	`{ statusCode, code, message }`

Example

curl -X DELETE 'https://latea.strangeskills.com/api/latea/series/id/{id}' \
  -H 'apikey: YOUR_API_KEY'

Taxes

get`/latea/taxes`

Get taxes

Responses

Status	Description	Body
`200`	Taxes information.	`TaxMeta[]`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/taxes' \
  -H 'apikey: YOUR_API_KEY'

post`/latea/taxes`

Put tax

Request body

application/json — { code, description, active }

Responses

Status	Description	Body
`201`	Tax information.	`TaxMeta`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/latea/taxes' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

put`/latea/taxes`

Update tax

Request body

application/json — { id, code, description, active }

Responses

Status	Description	Body
`200`	Tax information.	`TaxMeta`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/latea/taxes' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

get`/latea/taxes/id/{id}`

Get tax

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`200`	Tax information.	`Tax`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/taxes/id/{id}' \
  -H 'apikey: YOUR_API_KEY'

delete`/latea/taxes/id/{id}`

Delete tax

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`204`	Success.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X DELETE 'https://latea.strangeskills.com/api/latea/taxes/id/{id}' \
  -H 'apikey: YOUR_API_KEY'

put`/latea/taxes/regions`

Update tax region

Request body

application/json — { taxId, regions }

Responses

Status	Description	Body
`200`	Tax regions information.	`{ taxId, regions }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/latea/taxes/regions' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

Taxexemptions

get`/latea/taxexemptions`

Get tax exemptions

Responses

Status	Description	Body
`200`	Tax exemptions information.	`TaxExemption[]`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/latea/taxexemptions' \
  -H 'apikey: YOUR_API_KEY'

Account and platform

Auth

post`/auth`

Authenticate

Request body

application/json — object

Responses

Status	Description	Body
`204`	Success.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/auth' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

post`/auth/logout`

Logout

Responses

Status	Description	Body
`204`	Success.

Example

curl -X POST 'https://latea.strangeskills.com/api/auth/logout' \
  -H 'apikey: YOUR_API_KEY'

put`/auth/password`

Change Password

Request body

application/json — { password, newpassword }

Responses

Status	Description	Body
`204`	Success.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/auth/password' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

post`/auth/recover`

Request password recovery

Request body

application/json — PasswordRecoverRequest

Responses

Status	Description	Body
`204`	Success.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/auth/recover' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

post`/auth/recover/confirm`

Confirm password recovery

Request body

application/json — PasswordRecoverConfirm

Responses

Status	Description	Body
`204`	Success.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/auth/recover/confirm' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

get`/auth/user`

Authentication

Responses

Status	Description	Body
`200`	Auth data	`{ id, name, type, organizations, organizationId, apps }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/auth/user' \
  -H 'apikey: YOUR_API_KEY'

Generic

get`/generic/countries`

Get countries

Responses

Status	Description	Body
`200`	Countries information list.	`Country[]`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/generic/countries' \
  -H 'apikey: YOUR_API_KEY'

Organizations

get`/organizations`

Get organization

Responses

Status	Description	Body
`200`	Organization information.	`Organization`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/organizations' \
  -H 'apikey: YOUR_API_KEY'

post`/organizations`

Create organization

Request body

application/json — { name, taxNumber, email, password, address, key, app }

Responses

Status	Description	Body
`201`	Organization information.	`Organization`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/organizations' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

put`/organizations`

Update organization

Request body

application/json — { id, name, taxNumber, email, address }

Responses

Status	Description	Body
`200`	Organization information.	`Organization`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/organizations' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

get`/organizations/all`

Get all organizations (superadmin only)

Parameters

Name	In	Type	Required
`search`	query	`string`	no
`limit`	query	`integer`	no

Responses

Status	Description	Body
`200`	Organization list	`{ id, name, email, taxNumber }[]`

Example

curl -X GET 'https://latea.strangeskills.com/api/organizations/all' \
  -H 'apikey: YOUR_API_KEY'

get`/organizations/configuration`

Get organization configuration

Responses

Status	Description	Body
`200`	Organization configuration.	`{ organizationId, atUsername, atPassword }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/organizations/configuration' \
  -H 'apikey: YOUR_API_KEY'

put`/organizations/configuration`

Update organization configuration

Request body

application/json — { atUsername, atPassword }

Responses

Status	Description	Body
`200`	Organization configuration.	`{ organizationId, atUsername, atPassword }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/organizations/configuration' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

put`/organizations/logo`

Update organization logo

Request body

multipart/form-data — { file }

Responses

Status	Description	Body
`200`	Organization information.	`Organization`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/organizations/logo' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

delete`/organizations/{id}`

Delete organization

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`204`	Success.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X DELETE 'https://latea.strangeskills.com/api/organizations/{id}' \
  -H 'apikey: YOUR_API_KEY'

Subscriptions

post`/subscriptions`

Create subscription

Request body

application/json — { app, name }

Responses

Status	Description	Body
`201`	Subscription information.	`{ id, paymentStripeId, paymentURL }`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/subscriptions' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

get`/subscriptions/app-plans`

Get active app plans for organizations

Parameters

Name	In	Type	Required
`app`	query	`string`	yes

Responses

Status	Description	Body
`200`	List of active plans for the app	`Plan[]`
`default`	Error

Example

curl -X GET 'https://latea.strangeskills.com/api/subscriptions/app-plans' \
  -H 'apikey: YOUR_API_KEY'

post`/subscriptions/organization/{id}/cancel`

Cancel organization subscription at period end

Parameters

Name	In	Type	Required
`id`	path	`integer`	yes

Responses

Status	Description	Body
`204`	Subscription cancellation scheduled

Example

curl -X POST 'https://latea.strangeskills.com/api/subscriptions/organization/{id}/cancel' \
  -H 'apikey: YOUR_API_KEY'

post`/subscriptions/organization/{id}/change-plan`

Change organization subscription plan

Parameters

Name	In	Type	Required
`id`	path	`integer`	yes

Request body

application/json — { planId }

Responses

Status	Description	Body
`204`	Subscription updated

Example

curl -X POST 'https://latea.strangeskills.com/api/subscriptions/organization/{id}/change-plan' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

post`/subscriptions/organization/{id}/resume`

Resume organization subscription cancellation

Parameters

Name	In	Type	Required
`id`	path	`integer`	yes

Responses

Status	Description	Body
`204`	Subscription resumed

Example

curl -X POST 'https://latea.strangeskills.com/api/subscriptions/organization/{id}/resume' \
  -H 'apikey: YOUR_API_KEY'

get`/subscriptions/public/app-plans`

Get public app plans

Parameters

Name	In	Type	Required
`app`	query	`string`	yes

Responses

Status	Description	Body
`200`	List of active plans for the app	`Plan[]`
`default`	Error

Example

curl -X GET 'https://latea.strangeskills.com/api/subscriptions/public/app-plans' \
  -H 'apikey: YOUR_API_KEY'

get`/subscriptions/{app}`

Get subscription

Parameters

Name	In	Type	Required
`app`	path	`string`	yes

Responses

Status	Description	Body
`200`	Subscription meta information.	`Subscription`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/subscriptions/{app}' \
  -H 'apikey: YOUR_API_KEY'

Users

get`/users`

Get users

Responses

Status	Description	Body
`200`	User information.	`User[]`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/users' \
  -H 'apikey: YOUR_API_KEY'

post`/users`

Create user

Request body

application/json — { name, username, password }

Responses

Status	Description	Body
`201`	User information.	`User`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/users' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

put`/users`

Update user

Request body

application/json — { id, name, username, password }

Responses

Status	Description	Body
`200`	User information.	`User`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/users' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

get`/users/apikeys`

Get user api keys

Responses

Status	Description	Body
`200`	The keys of the app the caller is authenticated for. A key belongs to one app and the other apps never see it.	`APIKey[]`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X GET 'https://latea.strangeskills.com/api/users/apikeys' \
  -H 'apikey: YOUR_API_KEY'

post`/users/apikeys`

Create user api key

Request body

application/json — { name, readOnly }

Responses

Status	Description	Body
`201`	User API Key information.	`APIKey`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X POST 'https://latea.strangeskills.com/api/users/apikeys' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

put`/users/apikeys`

Update user api key

Request body

application/json — { id, name }

Responses

Status	Description	Body
`200`	User API Key information.	`APIKey`
`default`	Error	`{ statusCode, code, message }`

Example

curl -X PUT 'https://latea.strangeskills.com/api/users/apikeys' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ ... }'

delete`/users/apikeys/{id}`

Delete user api key

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`204`	Success.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X DELETE 'https://latea.strangeskills.com/api/users/apikeys/{id}' \
  -H 'apikey: YOUR_API_KEY'

delete`/users/{id}`

Delete user

Parameters

Name	In	Type	Required
`id`	path	`number`	yes

Responses

Status	Description	Body
`204`	Success.
`default`	Error	`{ statusCode, code, message }`

Example

curl -X DELETE 'https://latea.strangeskills.com/api/users/{id}' \
  -H 'apikey: YOUR_API_KEY'

Getting started

Base URL

Authentication

Errors

Model Context Protocol

Reference

Latea

Customer subscriptions

get/subscriptions/entity

Parameters

Responses

Example

post/subscriptions/entity

Request body

Responses

Example

get/subscriptions/entity/{id}

Parameters

Responses

Example

post/subscriptions/entity/{id}/cancel

Parameters

Responses

Example

post/subscriptions/entity/{id}/pause

Parameters

Responses

Example

post/subscriptions/entity/{id}/resume

Parameters

Responses

Example

Documents

get/latea/documents

Parameters

Responses

Example

post/latea/documents

Request body

Responses

Example

post/latea/documents/at/communicate

Request body

Responses

Example

put/latea/documents/cancel

Request body

Responses

Example

get/latea/documents/document/{id}/serie/{serieId}

Parameters

Responses

Example

get/latea/documents/summary

Responses

Example

Entities

get/latea/entities

Parameters

Responses

Example

post/latea/entities

Request body

Responses

Example

put/latea/entities

Request body

Responses

Example

post/latea/entities/address

Request body

Responses

Example

put/latea/entities/address

Request body

Responses

Example

delete/latea/entities/address/entity/{entityId}/id/{id}

Parameters

Responses

get`/subscriptions/entity`

post`/subscriptions/entity`

get`/subscriptions/entity/{id}`

post`/subscriptions/entity/{id}/cancel`

post`/subscriptions/entity/{id}/pause`

post`/subscriptions/entity/{id}/resume`

get`/latea/documents`

post`/latea/documents`

post`/latea/documents/at/communicate`

put`/latea/documents/cancel`

get`/latea/documents/document/{id}/serie/{serieId}`

get`/latea/documents/summary`

get`/latea/entities`

post`/latea/entities`

put`/latea/entities`

post`/latea/entities/address`

put`/latea/entities/address`

delete`/latea/entities/address/entity/{entityId}/id/{id}`

get`/latea/entities/id/{id}`

delete`/latea/entities/id/{id}`

get`/latea/entities/id/{id}/addresses`

get`/latea/exports/saft/{year}`

get`/latea/exports/saft/{year}/{month}`

get`/latea/products`

post`/latea/products`

put`/latea/products`

get`/latea/products/forline`

get`/latea/products/id/{id}`

delete`/latea/products/id/{id}`

post`/latea/products/info`

get`/latea/regions`

get`/latea/series`

post`/latea/series`

put`/latea/series`