Onfleet

Onfleet Destinations API

Manage geocoded physical addresses used as task pickup/dropoff locations. Accepts a parsed address structure or a single `unparsed` field; coordinates are returned as GeoJSON [longitude, latitude].

Onfleet Destinations API is one of 8 APIs that Onfleet publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Last Mile Delivery, Destinations, and Geocoding. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 JSON Schema.

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.onfleet.com/reference/create-destination.md

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/onfleet/refs/heads/main/openapi/onfleet-destinations-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/onfleet/refs/heads/main/json-schema/onfleet-destination-schema.json

OpenAPI Specification

onfleet-destinations-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: Onfleet Destinations API
  description: |
    The Destinations API manages physical addresses associated with tasks.
    Destinations include parsed address fields and a GeoJSON location, and can
    be reused across tasks. Onfleet geocodes addresses on creation; you can
    also supply an `unparsed` address.
  version: '2.7'
  contact:
    name: Onfleet Support
    email: [email protected]
  license:
    name: Onfleet Terms of Service
    url: https://onfleet.com/legal
servers:
  - url: https://onfleet.com/api/v2
    description: Production
security:
  - basicAuth: []
tags:
  - name: Destinations
paths:
  /destinations:
    post:
      tags: [Destinations]
      summary: Create Destination
      operationId: createDestination
      requestBody:
        required: true
        content:
          application/json:
            schema: {$ref: '#/components/schemas/DestinationCreate'}
      responses:
        '200':
          description: Destination created
          content:
            application/json:
              schema: {$ref: '#/components/schemas/Destination'}
  /destinations/{destinationId}:
    get:
      tags: [Destinations]
      summary: Get Destination
      operationId: getDestination
      parameters:
        - name: destinationId
          in: path
          required: true
          schema: {type: string}
      responses:
        '200':
          description: Destination
          content:
            application/json:
              schema: {$ref: '#/components/schemas/Destination'}
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
  schemas:
    Address:
      type: object
      properties:
        unparsed: {type: string}
        number: {type: string}
        street: {type: string}
        city: {type: string}
        state: {type: string}
        postalCode: {type: string}
        country: {type: string}
        apartment: {type: string}
    Destination:
      type: object
      properties:
        id: {type: string}
        timeCreated: {type: integer, format: int64}
        timeLastModified: {type: integer, format: int64}
        address: {$ref: '#/components/schemas/Address'}
        location:
          type: array
          minItems: 2
          maxItems: 2
          items: {type: number}
          description: GeoJSON [longitude, latitude].
        notes: {type: string}
        warnings:
          type: array
          items: {type: string}
        metadata:
          type: array
          items: {type: object}
    DestinationCreate:
      type: object
      properties:
        address:
          allOf:
            - $ref: '#/components/schemas/Address'
        location:
          type: array
          minItems: 2
          maxItems: 2
          items: {type: number}
        notes: {type: string}
        metadata:
          type: array
          items: {type: object}