Grubhub Deliveries API

naftiko: 1.0.0-alpha2
info:
  label: Grubhub Deliveries API
  description: The Grubhub Deliveries API enables partners to manage delivery logistics and interact with Grubhub's nationwide
    courier network. It provides delivery status tracking through key states including driver assignment, pickup ready, and
    out for delivery. Partners can leverage Grubhub Connect, a full-service delivery solution for delivery aggregators, marketplaces,
    and enterprise merchants to fulfill orders using Grubhub drivers. The API also supports driver communication through proxy
    phone numbers.
  tags:
  - Grubhub
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: grubhub
    baseUri: https://api-third-party-gtm.grubhub.com
    description: Grubhub Deliveries API HTTP API.
    authentication:
      type: apikey
      in: header
      name: Authorization
      value: '{{GRUBHUB_TOKEN}}'
    resources:
    - name: pos-v1-merchant-merchant-long-id-orders-order-uu
      path: /pos/v1/merchant/{merchant_long_id}/orders/{order_uuid}/delivery
      operations:
      - name: getdeliverystatus
        method: GET
        description: Get delivery status for an order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pos-v1-merchant-merchant-long-id-orders-order-uu
      path: /pos/v1/merchant/{merchant_long_id}/orders/{order_uuid}/delivery/proxy-phone
      operations:
      - name: createproxycourierphone
        method: POST
        description: Create proxy courier phone number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: grubhub-rest
    description: REST adapter for Grubhub Deliveries API.
    resources:
    - path: /pos/v1/merchant/{merchant_long_id}/orders/{order_uuid}/delivery
      name: getdeliverystatus
      operations:
      - method: GET
        name: getdeliverystatus
        description: Get delivery status for an order
        call: grubhub.getdeliverystatus
        outputParameters:
        - type: object
          mapping: $.
    - path: /pos/v1/merchant/{merchant_long_id}/orders/{order_uuid}/delivery/proxy-phone
      name: createproxycourierphone
      operations:
      - method: POST
        name: createproxycourierphone
        description: Create proxy courier phone number
        call: grubhub.createproxycourierphone
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: grubhub-mcp
    transport: http
    description: MCP adapter for Grubhub Deliveries API for AI agent use.
    tools:
    - name: getdeliverystatus
      description: Get delivery status for an order
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: grubhub.getdeliverystatus
      outputParameters:
      - type: object
        mapping: $.
    - name: createproxycourierphone
      description: Create proxy courier phone number
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: grubhub.createproxycourierphone
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    GRUBHUB_TOKEN: GRUBHUB_TOKEN