Costs

Endpoints for managing cost definitions and their associated values per account.

---

Index Cost Types

GET https://api.mitrabajo.uy/cost-types

Returns a paginated list of cost type definitions for your account.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl https://api.mitrabajo.uy/cost-types \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

{
  "items": [
    {
      "Id": 1,
      "Descripcion": "Horas extra",
      "Periodo": "H",
      "ValorxDefecto": 150.00
    }
  ],
  "_links": {
    "self": { "href": "https://api.mitrabajo.uy/cost-types?page=1" }
  },
  "_meta": {
    "totalCount": 1,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 20
  }
}

---

View Cost Type

GET https://api.mitrabajo.uy/cost-types/{id}

Returns a single cost type definition.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl https://api.mitrabajo.uy/cost-types/1 \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

{
  "Id": 1,
  "Descripcion": "Horas extra",
  "Periodo": "H",
  "ValorxDefecto": 150.00
}

---

Create Cost Type

POST https://api.mitrabajo.uy/cost-types

Creates a new cost type definition. Returns the created object with 201 Created.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes
Content-Type	application/json	Yes

Request Body

Field	Type	Required	Constraints
Descripcion	string	Yes	Max 50 characters
Periodo	string	No	One of: H (Hour), D (Day), M (Month)
ValorxDefecto	number	No	Default unit value

Example

curl -X POST https://api.mitrabajo.uy/cost-types \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-" \
  -H "Content-Type: application/json" \
  -d '{
    "Descripcion": "Viáticos",
    "Periodo": "D",
    "ValorxDefecto": 500.00
  }'

Response

{
  "Id": 2,
  "Descripcion": "Viáticos",
  "Periodo": "D",
  "ValorxDefecto": 500.00
}

---

Update Cost Type

PATCH https://api.mitrabajo.uy/cost-types/{id}

PUT https://api.mitrabajo.uy/cost-types/{id}

Updates an existing cost type. Returns the updated object with 200 OK.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes
Content-Type	application/json	Yes

Request Body

Same fields as Create Cost Type. With PATCH, only include the fields to change.

Example

curl -X PATCH https://api.mitrabajo.uy/cost-types/2 \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-" \
  -H "Content-Type: application/json" \
  -d '{
    "ValorxDefecto": 600.00
  }'

Response

{
  "Id": 2,
  "Descripcion": "Viáticos",
  "Periodo": "D",
  "ValorxDefecto": 600.00
}

---

Delete Cost Type

DELETE https://api.mitrabajo.uy/cost-types/{id}

Deletes a cost type definition. Returns 204 No Content on success.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl -X DELETE https://api.mitrabajo.uy/cost-types/2 \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

204 No Content — empty body on success.

---

Index Costs

GET https://api.mitrabajo.uy/costs

Returns a paginated list of cost records for your account. Supports optional filtering by Costo_Id.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None. Filters are passed as query string.

Filter field	Type	Description
filter[Costo_Id]	integer	Filter by cost type ID

Example

curl "https://api.mitrabajo.uy/costs?filter[Costo_Id]=1" \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

{
  "items": [
    {
      "Id": 10,
      "Costo_Id": 1,
      "Externo_Id": 42,
      "Relacionado": "EMPLEADO",
      "Fecha_Desde": "2026-01-01",
      "Fecha_Hasta": null,
      "Valor": 175.00,
      "Observaciones": "Ajuste enero 2026"
    }
  ],
  "_links": {
    "self": { "href": "https://api.mitrabajo.uy/costs?page=1" }
  },
  "_meta": {
    "totalCount": 1,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 20
  }
}

---

View Cost

GET https://api.mitrabajo.uy/costs/{id}

Returns a single cost record.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl https://api.mitrabajo.uy/costs/10 \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

{
  "Id": 10,
  "Costo_Id": 1,
  "Externo_Id": 42,
  "Relacionado": "EMPLEADO",
  "Fecha_Desde": "2026-01-01",
  "Fecha_Hasta": null,
  "Valor": 175.00,
  "Observaciones": "Ajuste enero 2026"
}

---

Create Cost

POST https://api.mitrabajo.uy/costs

Creates a new cost record. Returns the created object with 201 Created.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes
Content-Type	application/json	Yes

Request Body

Field	Type	Required	Constraints
Costo_Id	integer	Yes	ID of the cost type
Externo_Id	integer	Yes	ID of the related entity (employee, category, or scheme)
Fecha_Desde	string	Yes	Start date — format YYYY-MM-DD
Relacionado	string	No	One of: CATEGORIA, EMPLEADO, ESQUEMA
Fecha_Hasta	string	No	End date — format YYYY-MM-DD
Valor	number	No	Actual cost value
Observaciones	string	No	Notes, max 50 characters

Example

curl -X POST https://api.mitrabajo.uy/costs \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-" \
  -H "Content-Type: application/json" \
  -d '{
    "Costo_Id": 1,
    "Externo_Id": 42,
    "Relacionado": "EMPLEADO",
    "Fecha_Desde": "2026-07-01",
    "Valor": 175.00,
    "Observaciones": "Ajuste julio 2026"
  }'

Response

{
  "Id": 11,
  "Costo_Id": 1,
  "Externo_Id": 42,
  "Relacionado": "EMPLEADO",
  "Fecha_Desde": "2026-07-01",
  "Fecha_Hasta": null,
  "Valor": 175.00,
  "Observaciones": "Ajuste julio 2026"
}

---

Update Cost

PATCH https://api.mitrabajo.uy/costs/{id}

PUT https://api.mitrabajo.uy/costs/{id}

Updates an existing cost record. Returns the updated object with 200 OK.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes
Content-Type	application/json	Yes

Request Body

Same fields as Create Cost. With PATCH, only include the fields to change.

Example

curl -X PATCH https://api.mitrabajo.uy/costs/11 \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-" \
  -H "Content-Type: application/json" \
  -d '{
    "Fecha_Hasta": "2026-12-31",
    "Valor": 200.00
  }'

Response

{
  "Id": 11,
  "Costo_Id": 1,
  "Externo_Id": 42,
  "Relacionado": "EMPLEADO",
  "Fecha_Desde": "2026-07-01",
  "Fecha_Hasta": "2026-12-31",
  "Valor": 200.00,
  "Observaciones": "Ajuste julio 2026"
}

---

Delete Cost

DELETE https://api.mitrabajo.uy/costs/{id}

Deletes a cost record. Returns 204 No Content on success.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl -X DELETE https://api.mitrabajo.uy/costs/11 \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

204 No Content — empty body on success.