> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grdd.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Status by Reservation

> Provider systems push status changes to GNet by Reservation #

<Note>
  Call this endpoint whenever there is a change in Status, Driver Info, Vehicle Info, Charge line items, or Total. See [Status Codes](/platform-api/reference/status-codes) for the full list of valid status values.
</Note>


## OpenAPI

````yaml platform-api/openapi.json POST /providerUpdateStatusByResNo/{GRIDDID}/{RESNO}/{version}
openapi: 3.1.0
info:
  title: GNet Platform API
  description: >-
    RESTful API for exchanging ground transportation reservations over the GNet
    Platform (Platform.svc). Requesters send (farm-out) reservations; providers
    receive (farm-in) reservations and push status updates back.
  version: V1
  contact:
    name: GRiDD Support
    email: support@grdd.net
servers:
  - url: https://api.grdd.net/Platform.svc
    description: Production
security:
  - tokenAuth: []
tags:
  - name: Authentication
    description: Obtain and release security tokens
  - name: Reservations
    description: Submit, retrieve, cancel, and retry reservations
  - name: Provider Updates
    description: Provider systems push status changes to GNet
  - name: Tracking
    description: Real-time chauffeur/vehicle location
paths:
  /providerUpdateStatusByResNo/{GRIDDID}/{RESNO}/{version}:
    post:
      tags:
        - Provider Updates
      summary: 'Update status by Reservation #'
      description: >-
        Called by **provider systems** upon a status code change. Call it
        whenever there is a change in Status, Driver Info, Vehicle Info, Charge
        line items, or Total.
      operationId: providerUpdateStatusByResNo
      parameters:
        - $ref: '#/components/parameters/griddId'
        - $ref: '#/components/parameters/resNo'
        - $ref: '#/components/parameters/version'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProviderStatusUpdate'
      responses:
        '200':
          description: Update accepted
          content:
            application/json:
              schema:
                type: string
              example: OK
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  parameters:
    griddId:
      name: GRIDDID
      in: path
      required: true
      description: GRiDD ID.
      schema:
        type: string
    resNo:
      name: RESNO
      in: path
      required: true
      description: 'Reservation #.'
      schema:
        type: string
    version:
      name: version
      in: path
      required: true
      description: API version. Must be set to `V1`.
      schema:
        type: string
        enum:
          - V1
  schemas:
    ProviderStatusUpdate:
      type: object
      description: >-
        Status update pushed by the provider system. Include chauffeur, vehicle,
        fees, and total when they change.
      required:
        - status
        - griddID
      properties:
        status:
          type: string
          description: New status code. See the Status Codes reference.
          example: EN_ROUTE
        griddID:
          type: string
          description: GRiDD ID of the provider.
          example: 4starlimo
        resNo:
          type: string
          description: 'Provider reservation #.'
          example: '756333'
        requesterResNo:
          type: string
          description: 'Requester reservation #.'
          example: '12343'
        transactionId:
          type: string
          example: c1df1d28-0608-4df7-b268-cc68ba175ed6
        totalAmount:
          type: string
          example: '124.75'
        providerNote:
          type: string
          description: Free-form notes from the provider on this trip.
        LocalTimestamp:
          type: string
          example: '2016-04-13T19:15:00'
        UTCtimestamp:
          type: string
          example: '2016-04-14T04:15:00'
        chauffeur:
          $ref: '#/components/schemas/Chauffeur'
        vehicle:
          $ref: '#/components/schemas/Vehicle'
        fees:
          type: array
          items:
            $ref: '#/components/schemas/Fee'
    Chauffeur:
      type: object
      properties:
        chauffeurId:
          type: string
          example: 01-abc
        firstName:
          type: string
          example: Joe
        lastName:
          type: string
          example: Smith
        email:
          type: string
          example: joe@limo1.com
        phoneNumber:
          type: string
          example: 212.222.2222
        picURL:
          type: string
          description: URL of the chauffeur's photo.
    Vehicle:
      type: object
      properties:
        vehicleId:
          type: string
          example: '101'
        vehicleType:
          type: string
          example: sedan
        make:
          type: string
          example: BMW
        model:
          type: string
          example: 750iL
        year:
          type: string
          example: '2017'
        vin:
          type: string
        mileage:
          type: string
        passengerCount:
          type: string
          example: '3'
    Fee:
      type: object
      properties:
        code:
          type: string
          example: base
        currency:
          type: string
          example: USD
        description:
          type: string
          example: Base charges
        fee:
          type: string
          example: '75.00'
        percent:
          type:
            - string
            - 'null'
        reimbursable:
          type:
            - string
            - 'null'
        type:
          type: string
          description: Fee type, e.g. CHARGE, EXPENSE, EXTRA_SERVICE.
          example: EXPENSE
  responses:
    BadRequest:
      description: Bad Request
    Unauthorized:
      description: Unauthorized — missing or invalid `token` header
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: token
      description: Security token obtained from `getToken2`.

````