Create a point of interest

curl --request POST \
  --url https://app.unitedlogistics.com.do/api/v1/pois \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fleet_id": 1029,
  "name": "Cliente Altice – Bávaro",
  "description": "Punto de entrega cliente Altice zona este",
  "geometry_type": "circle",
  "latitude": 18.6792,
  "longitude": -68.4014,
  "geofence_radius_meters": 250,
  "tags": [
    "cliente",
    "distribución-este"
  ]
}
'

{
  "data": {
    "id": 481,
    "org_id": "d87f7281-ea19-45cd-b6fd-d8eb9e310da1",
    "fleet_id": 1029,
    "name": "Cliente Altice – Bávaro",
    "description": "Punto de entrega cliente Altice zona este",
    "latitude": 18.6792,
    "longitude": -68.4014,
    "image_url": null,
    "geometry_type": "circle",
    "geofence_radius_meters": 250,
    "polygon_coordinates": null,
    "tags": [
      "cliente",
      "distribución-este"
    ],
    "created_at": "2025-09-15T13:00:00.000Z",
    "updated_at": "2026-04-22T18:45:11.221Z"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Invalid POI payload.",
    "details": {
      "fieldErrors": {
        "geofence_radius_meters": [
          "geofence_radius_meters es requerido para geocercas circulares"
        ]
      }
    }
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "API key missing or invalid."
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "La flota no está asignada a tu organización."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "La flota especificada no existe."
  }
}

{
  "error": {
    "code": "too_many_requests",
    "message": "Rate limit exceeded."
  }
}

POST

pois

curl --request POST \
  --url https://app.unitedlogistics.com.do/api/v1/pois \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fleet_id": 1029,
  "name": "Cliente Altice – Bávaro",
  "description": "Punto de entrega cliente Altice zona este",
  "geometry_type": "circle",
  "latitude": 18.6792,
  "longitude": -68.4014,
  "geofence_radius_meters": 250,
  "tags": [
    "cliente",
    "distribución-este"
  ]
}
'

{
  "data": {
    "id": 481,
    "org_id": "d87f7281-ea19-45cd-b6fd-d8eb9e310da1",
    "fleet_id": 1029,
    "name": "Cliente Altice – Bávaro",
    "description": "Punto de entrega cliente Altice zona este",
    "latitude": 18.6792,
    "longitude": -68.4014,
    "image_url": null,
    "geometry_type": "circle",
    "geofence_radius_meters": 250,
    "polygon_coordinates": null,
    "tags": [
      "cliente",
      "distribución-este"
    ],
    "created_at": "2025-09-15T13:00:00.000Z",
    "updated_at": "2026-04-22T18:45:11.221Z"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Invalid POI payload.",
    "details": {
      "fieldErrors": {
        "geofence_radius_meters": [
          "geofence_radius_meters es requerido para geocercas circulares"
        ]
      }
    }
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "API key missing or invalid."
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "La flota no está asignada a tu organización."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "La flota especificada no existe."
  }
}

{
  "error": {
    "code": "too_many_requests",
    "message": "Rate limit exceeded."
  }
}

Authorizations

Authorization

string

header

required

Authorization: Bearer ulk__. Cree la clave en Configuración → API.

Body

application/json

fleet_id

integer

required

Fleet (provider account) this POI is scoped to.

Example:

1029

name

string

required

Human-readable name.

Required string length: 1 - 255

Example:

"Cliente Altice – Bávaro"

description

string | null

Free-form description.

Maximum string length: 2000

Example:

"Punto de entrega cliente Altice zona este"

image_url

string<uri> | null

Public image URL (typically Supabase storage poi-images bucket).

Example:

null

geometry_type

enum<string>

default:circle

circle for radius-based geofences, polygon for arbitrary shapes.

Available options:

circle,

polygon

Example:

"circle"

latitude

number

Required for circle. For polygon, derived from centroid if omitted.

Required range: -90 <= x <= 90

Example:

18.6792

longitude

number

Required for circle. For polygon, derived from centroid if omitted.

Required range: -180 <= x <= 180

Example:

-68.4014

geofence_radius_meters

integer | null

Required for circle. 10–1000 meters. null for polygons.

Required range: 10 <= x <= 1000

Example:

250

polygon_coordinates

tuple[] | null

Required for polygon. At least 3 [lat, lng] vertices; the polygon is closed automatically.

Required array length: 3 - 500 elements

Show child attributes

Example:

[
  [18.5012, -69.9305],
  [18.5012, -69.929],
  [18.5, -69.929],
  [18.5, -69.9305]
]

Response

Created

data

object

required

Show child attributes

Guía

Referencia

Authorizations

Body

Response