find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/lytx-zones-go9-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Lytx Zones (GO9) API
  version: 1.0.0
  description: 'Operations tagged Zones (GO9) across 2 of this provider''s published API definitions: lytx-zonesplus-openapi.yml, lytx-zonesputandpostplus-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.lytx.com
security:
- bearerAuth: []
tags:
- name: Zones (GO9)
paths:
  /plus/v1/zones:
    get:
      summary: Get Telematics Zones Data
      description: Retrieve a list of Geofences/Zones
      tags:
      - Zones (GO9)
      parameters:
      - name: groupId
        in: query
        required: false
        schema:
          type:
          - string
          - 'null'
          example: 5100FFFF-60B6-D7CD-3FA2-22CA712B0000
        description: Can use group ID or root group ID.
      - name: includeSubGroups
        in: query
        required: false
        schema:
          type: boolean
          example: 'false'
          default: true
        description: If true, all descendant groups under the specified group are included.
      - name: limit
        in: query
        required: false
        schema:
          type:
          - integer
          - 'null'
          example: '5000'
        description: Number of records to return.
      - name: offset
        in: query
        required: false
        schema:
          type:
          - integer
          - 'null'
          example: '1500'
        description: Record to start with.
      - name: startDate
        in: query
        required: false
        schema:
          type: string
          format: date-time
          example: '2023-06-01'
        description: The start date must be within the last 60 days.
      - name: endDate
        in: query
        required: false
        schema:
          type: string
          format: date-time
          example: '2023-06-02'
        description: End date to filter by.
      - name: order
        in: query
        required: false
        schema:
          type:
          - string
          - 'null'
          example: asc
        description: Sort direction.
      - name: sortProperty
        in: query
        required: false
        schema:
          type:
          - string
          - 'null'
          example: name
        description: Name of property to sort on.
      - name: version
        in: query
        required: true
        schema:
          type:
          - string
          - 'null'
          example: 1
        description: API version number.
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ZoneResponseViewModel'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Bad Request
                  message:
                    type: string
                    example: Invalid request data
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Unauthorized
                  message:
                    type: string
                    example: Access denied
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Forbidden
                  message:
                    type: string
                    example: Non-permited user
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Not Found
                  message:
                    type: string
                    example: No information found
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Internal Server Error
                  message:
                    type: string
                    example: An unexpected server error occurred
    post:
      summary: Add Telematics Zones Data
      description: Add data for Geofences/Zones
      tags:
      - Zones (GO9)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddZonesRequestViewModel'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: string
                example: bb5
                description: Unique identifier of the zone returned after a successful creation.
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Bad Request
                  message:
                    type: string
                    example: Invalid ShapeType
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Unauthorized
                  message:
                    type: string
                    example: Access denied
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Forbidden
                  message:
                    type: string
                    example: Non-permitted user
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Not Found
                  message:
                    type: string
                    example: No information found
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Internal Server Error
                  message:
                    type: string
                    example: An unexpected server error occurred
    put:
      summary: Edit Telematics Zones Data
      description: Edit data for Geofences/Zones
      tags:
      - Zones (GO9)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditZonesRequestViewModel'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: string
                example: Zone with Id bb5 updated Successfully
                description: Confirmation message indicating that the zone was updated successfully.
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Bad Request
                  message:
                    type: string
                    example: Invalid request data
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Unauthorized
                  message:
                    type: string
                    example: Access denied
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Forbidden
                  message:
                    type: string
                    example: Non-permitted user
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Not Found
                  message:
                    type: string
                    example: No information found
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: string
                    example: Internal Server Error
                  message:
                    type: string
                    example: An unexpected server error occurred
    servers:
    - url: https://api.lytx.com
components:
  schemas:
    ColorResponseViewModel:
      type: object
      properties:
        a:
          type: integer
          example: 255
          description: Alpha channel (transparency).
        r:
          type: integer
          example: 255
          description: Red channel (0-255).
        g:
          type: integer
          example: 0
          description: Green channel (0-255).
        b:
          type: integer
          example: 0
          description: Blue channel (0-255).
    ZoneTypeResponseViewModel:
      type: object
      properties:
        comment:
          type: string
          example: Default restricted zone type
          description: Comment for the zone type.
        defaultFillColorForNewZoneType:
          type:
          - object
          - 'null'
          description: Default fill color for a new zone type.
        fillColor:
          type:
          - object
          - 'null'
          description: Custom fill color for the zone type.
        id:
          type: object
          description: Identifier for the zone type.
        isBuiltIn:
          type: boolean
          example: true
          description: Indicates if the zone type is built-in.
        name:
          type: string
          example: Restricted Area
          description: Name of the zone type.
    CoordinateResponseViewModel:
      type: object
      properties:
        x:
          type: number
          format: double
          example: -117.212799
          description: X coordinate (longitude).
        y:
          type: number
          format: double
          example: 32.8872185
          description: Y coordinate (latitude).
    ZoneResponseViewModel:
      type: object
      properties:
        activeFrom:
          type:
          - string
          - 'null'
          format: date-time
          example: '2025-05-29T19:18:26.063Z'
          description: Start date/time when the zone is active.
        activeTo:
          type:
          - string
          - 'null'
          format: date-time
          example: '2025-06-29T19:18:26.063Z'
          description: End date/time when the zone is active.
        comment:
          type:
          - string
          - 'null'
          example: Restricted area for heavy vehicles
          description: Optional comment for the zone.
        displayed:
          type: boolean
          example: true
          description: Indicates whether the zone is displayed on the map.
        externalReference:
          type: string
          example: zone-ext-12345
          description: External reference identifier.
        fillColor:
          $ref: '#/components/schemas/ColorResponseViewModel'
        groups:
          type: array
          items:
            type: string
          example:
          - group1
          - group2
          description: List of groups associated with the zone.
        id:
          type: string
          example: zone1f6e56d-1234-4567-89ab-cdef12345678
          description: Unique identifier of the zone.
        metadata:
          type:
          - object
          - 'null'
          description: Metadata information for the zone.
        mustIdentifyStops:
          type: boolean
          example: false
          description: Indicates whether stops must be identified within the zone.
        name:
          type: string
          example: No Parking Zone
          description: Name of the zone.
        points:
          type: array
          items:
            $ref: '#/components/schemas/CoordinateResponseViewModel'
          description: List of coordinates representing the zone polygon.
        version:
          type: string
          example: v1.0
          description: Version of the zone record.
        zoneTypes:
          type: array
          items:
            $ref: '#/components/schemas/ZoneTypeResponseViewModel'
          description: Types associated with the zone.
    CreateZoneGroupRequestViewModel:
      type: object
      required:
      - id
      properties:
        id:
          type: string
          example: group-12345
          description: Identifier of the group the zone belongs to.
    CreateZoneColorRequestViewModel:
      type: object
      properties:
        r:
          type: integer
          example: 255
          description: Red color component.
        g:
          type: integer
          example: 0
          description: Green color component.
        b:
          type: integer
          example: 0
          description: Blue color component.
        a:
          type: integer
          example: 255
          description: Alpha (opacity) color component.
    AddZonesRequestViewModel:
      type: object
      required:
      - name
      - points
      - groups
      properties:
        name:
          type: string
          example: San Diego Zone
          description: Name of the zone.
        comment:
          type:
          - string
          - 'null'
          example: Primary service area for San Diego
          description: Optional comment or description for the zone.
        mustIdentifyStops:
          type:
          - boolean
          - 'null'
          example: true
          description: Indicates whether stops must be identified within the zone.
        displayed:
          type:
          - boolean
          - 'null'
          example: true
          description: Indicates whether the zone is visible in the UI.
        activeFrom:
          type:
          - string
          - 'null'
          example: '2025-01-01T00:00:00Z'
          description: Date and time from which the zone becomes active.
        activeTo:
          type:
          - string
          - 'null'
          example: '2025-12-31T23:59:59Z'
          description: Date and time until which the zone remains active.
        zoneTypes:
          type: array
          description: List of zone types applicable to this zone.
          items:
            $ref: '#/components/schemas/ZoneTypesEnumRequestViewModel'
          example: Customer
        fillColor:
          $ref: '#/components/schemas/CreateZoneColorRequestViewModel'
        externalReference:
          type:
          - string
          - 'null'
          example: EXT-ZONE-001
          description: External reference identifier for the zone.
        points:
          type: array
          description: List of geographic points defining the zone boundary.
          items:
            $ref: '#/components/schemas/CreateZonePointRequestViewModel'
        groups:
          type: array
          description: Groups to which the zone belongs.
          items:
            $ref: '#/components/schemas/CreateZoneGroupRequestViewModel'
    EditZonesRequestViewModel:
      type: object
      required:
      - id
      properties:
        id:
          type: string
          example: b28
          description: Unique identifier of the zone to be updated.
        name:
          type:
          - string
          - 'null'
          example: San Diego Zone
          description: Updated name of the zone.
        comment:
          type:
          - string
          - 'null'
          example: Primary service area for San Diego
          description: Optional comment or description for the zone.
        mustIdentifyStops:
          type:
          - boolean
          - 'null'
          example: true
          description: Indicates whether stops must be identified within the zone.
        displayed:
          type:
          - boolean
          - 'null'
          example: true
          description: Indicates whether the zone is visible in the UI.
        externalReference:
          type:
          - string
          - 'null'
          example: EXT-ZONE-001
          description: External reference identifier for the zone.
        activeFrom:
          type:
          - string
          - 'null'
          example: '2025-01-01T00:00:00Z'
          description: Date and time from which the zone becomes active.
        activeTo:
          type:
          - string
          - 'null'
          example: '2025-12-31T23:59:59Z'
          description: Date and time until which the zone remains active.
        zoneTypes:
          type:
          - array
          - 'null'
          description: List of zone types applicable to this zone.
          items:
            $ref: '#/components/schemas/ZoneTypesEnumRequestViewModel'
          example: Customer
        fillColor:
          $ref: '#/components/schemas/CreateZoneColorRequestViewModel'
        points:
          type:
          - array
          - 'null'
          description: List of geographic points defining the updated zone boundary.
          items:
            $ref: '#/components/schemas/CreateZonePointRequestViewModel'
        groups:
          type:
          - array
          - 'null'
          description: Groups to which the zone belongs.
          items:
            $ref: '#/components/schemas/CreateZoneGroupRequestViewModel'
    ZoneTypesEnumRequestViewModel:
      type: string
      description: Type of zone.
      enum:
      - Customer
      - Home
      - InHouseServiceCenter
      - Office
      - VendorServiceCenter
    CreateZonePointRequestViewModel:
      type: object
      required:
      - x
      - y
      properties:
        x:
          type: number
          format: double
          example: 32.7157
          description: X coordinate (longitude).
        y:
          type: number
          format: double
          example: -117.1611
          description: Y coordinate (latitude).
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
x-refined-from:
- lytx-zonesplus-openapi.yml
- lytx-zonesputandpostplus-openapi.yml