> ## Documentation Index > Fetch the complete documentation index at: https://docs.unitedpetroleum.app/llms.txt > Use this file to discover all available pages before exploring further. # List points of interest > Returns POIs (geofences) for your org. Each POI is either a circle (point + `geofence_radius_meters`) or a polygon (`polygon_coordinates`). Ordered by `id` ascending so the cursor is stable. ## OpenAPI ````yaml /openapi.json get /pois openapi: 3.1.0 info: title: United Logistics API version: 0.1.0 description: >- Industry-grade public API for fleet, fuel, and toll operations. Every endpoint is scoped to the organization owning the API key. Authentication: bearer API key (`ulk__`). Rate limit: 60 requests/minute/key by default (override per key via the dashboard). contact: name: United Logistics Engineering email: sfuentes@assetmg.tech servers: - url: https://app.unitedlogistics.com.do/api/v1 description: Production - url: http://localhost:3000/api/v1 description: Local development security: - ApiKeyAuth: [] paths: /pois: get: tags: - POIs summary: List points of interest description: >- Returns POIs (geofences) for your org. Each POI is either a circle (point + `geofence_radius_meters`) or a polygon (`polygon_coordinates`). Ordered by `id` ascending so the cursor is stable. parameters: - schema: type: string pattern: ^\d+$ description: Page size, 1-200. Defaults to 50. required: false name: limit in: query - schema: type: string description: >- Opaque cursor returned by a previous call's `pagination.next_cursor`. required: false name: cursor in: query - schema: type: string pattern: ^\d+$ description: Filter by fleet (provider account) id. required: false name: fleet_id in: query responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/POIListResponse' example: 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' - id: 612 org_id: d87f7281-ea19-45cd-b6fd-d8eb9e310da1 fleet_id: 1029 name: Patio operativo Santo Domingo description: null latitude: 18.5006 longitude: -69.9298 image_url: null geometry_type: polygon geofence_radius_meters: null polygon_coordinates: - - 18.5012 - -69.9305 - - 18.5012 - -69.929 - - 18.5 - -69.929 - - 18.5 - -69.9305 tags: - patio - operaciones created_at: '2026-01-08T09:14:22.000Z' updated_at: '2026-01-08T09:14:22.000Z' pagination: next_cursor: eyJpZCI6NjEyfQ has_more: true '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorObject' example: error: code: unauthorized message: API key missing or invalid. '429': description: Rate limited content: application/json: schema: $ref: '#/components/schemas/ErrorObject' example: error: code: too_many_requests message: Rate limit exceeded. security: - ApiKeyAuth: [] components: schemas: POIListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/POI' pagination: $ref: '#/components/schemas/PaginationCursor' required: - data - pagination ErrorObject: type: object properties: error: type: object properties: code: type: string example: unauthorized message: type: string example: Missing Authorization header. details: {} required: - code - message required: - error POI: type: object properties: id: type: integer description: Internal numeric POI id. Stable for the lifetime of the POI. example: 42 org_id: type: string format: uuid fleet_id: type: - integer - 'null' description: Fleet (provider account) this POI is scoped to. example: 1029 name: type: string example: Estación La Vega description: type: - string - 'null' latitude: type: number example: 19.221 longitude: type: number example: -70.529 image_url: type: - string - 'null' geometry_type: type: string enum: - circle - polygon description: '`circle` for radius-based geofences, `polygon` for arbitrary shapes.' example: circle geofence_radius_meters: type: - integer - 'null' description: >- Radius in meters for circle geofences (10-1000). `null` for polygons. example: 50 polygon_coordinates: type: - array - 'null' items: type: array prefixItems: - type: number - type: number description: >- Polygon vertices as `[latitude, longitude]` tuples. Closed automatically (no need to repeat the first point). example: - - 18.5 - -69.9 - - 18.51 - -69.9 - - 18.51 - -69.89 - - 18.5 - -69.89 tags: type: array items: type: string description: User-defined tags used for filtering and reports. example: - estacion - gasolinera created_at: type: string updated_at: type: string required: - id - org_id - fleet_id - name - description - latitude - longitude - image_url - geometry_type - geofence_radius_meters - polygon_coordinates - tags - created_at - updated_at PaginationCursor: type: object properties: next_cursor: type: - string - 'null' description: >- Opaque cursor for the next page. Null when there are no more results. example: eyJpZCI6IjAxQUI... has_more: type: boolean required: - next_cursor - has_more securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: ulk__ description: >- Authorization: Bearer ulk__. Cree la clave en Configuración → API. ````