> ## Documentation Index > Fetch the complete documentation index at: https://docs.sparkserv.com/llms.txt > Use this file to discover all available pages before exploring further. # Read a Spark appointment snapshot > Does not refresh the scheduler. ## OpenAPI ````yaml https://api.sparkserv.com/public/api/swagger.json get /appointments/{id} openapi: 3.1.0 info: title: Spark Public API description: >- Dealership discovery and vehicle-specific appointment scheduling. Obtain a token with POST https://auth.sparkserv.com/oauth/token, Content-Type: application/json, and a body containing grant_type: client_credentials, client_id, client_secret, audience: https://api.sparkserv.com/public, and the requested scope string. Send Authorization: Bearer on API requests. Keep client secrets on your server, not in browser applications. Required scopes must be granted both in the token and on the active Spark API client. Dealership access follows its acting-user team memberships. Availability is not a reservation. Booking has no durable idempotency guarantee. Do not blindly retry mutations after timeouts or unknown outcomes; Spark appointment reads are local snapshots, not proof of the current upstream state. Unknown outcomes require reconciliation with the dealership or scheduler. version: '1' contact: {} servers: - url: https://api.sparkserv.com/public/v1 description: Current API environment security: [] tags: [] paths: /appointments/{id}: get: tags: - Appointments summary: Read a Spark appointment snapshot description: Does not refresh the scheduler. operationId: findPublicAppointmentV1 parameters: - name: id required: true in: path description: Spark appointment UUIDv4 schema: type: string format: uuid responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/PublicAppointmentDetailsV1ResponseDto' '400': description: >- Invalid request. Inspect code and details and correct the input before retrying. content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorResponseDto' examples: invalidInput: summary: Correct the request fields value: statusCode: 400 code: INVALID_INPUT message: Request validation failed '401': description: >- Missing, invalid or expired client-credentials token, or an inactive client. Obtain a valid token for an active client. content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorResponseDto' examples: unauthorized: summary: Authenticate with an active client value: statusCode: 401 code: UNAUTHORIZED message: The request could not be completed '403': description: The token or active API client lacks a required action scope. content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorResponseDto' examples: forbidden: summary: Grant the required scope and obtain a new token value: statusCode: 403 code: FORBIDDEN message: The request could not be completed '404': description: >- The resource does not exist or is outside the client's dealership access. content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorResponseDto' examples: notFound: summary: Check the resource and dealership access value: statusCode: 404 code: NOT_FOUND message: Resource not found '500': description: An unexpected server error prevented the request from completing. content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorResponseDto' examples: requestFailed: summary: Report the unexpected failure value: statusCode: 500 code: REQUEST_FAILED message: The request could not be completed security: - oauth2: - appointments:read components: schemas: PublicAppointmentDetailsV1ResponseDto: type: object properties: id: type: string format: uuid dealership: $ref: '#/components/schemas/PublicAppointmentDealershipV1ResponseDto' status: type: string enum: - Pending - Canceled - Showed - Missed - Duplicate - Completed - Sold appointmentAt: type: string format: date-time timezone: type: string customer: $ref: '#/components/schemas/PublicAppointmentCustomerV1ResponseDto' vehicle: $ref: '#/components/schemas/PublicAppointmentVehicleV1ResponseDto' department: oneOf: - $ref: '#/components/schemas/PublicAppointmentDepartmentV1ResponseDto' - type: 'null' advisor: $ref: '#/components/schemas/PublicAppointmentAdvisorV1ResponseDto' transport: $ref: '#/components/schemas/PublicAppointmentTransportV1ResponseDto' comments: oneOf: - type: string - type: 'null' services: type: array items: $ref: '#/components/schemas/PublicAppointmentServiceV1ResponseDto' required: - id - dealership - status - appointmentAt - timezone - customer - vehicle - department - advisor - transport - comments - services PublicApiErrorResponseDto: type: object properties: statusCode: type: integer code: type: string description: Stable machine-readable error code message: type: string details: description: >- Validation messages or contextual fields/choices; never raw scheduler error data oneOf: - type: object additionalProperties: true - type: array items: type: string required: - statusCode - code - message PublicAppointmentDealershipV1ResponseDto: type: object properties: id: type: string format: uuid required: - id PublicAppointmentCustomerV1ResponseDto: type: object properties: id: type: string format: uuid firstName: oneOf: - type: string - type: 'null' lastName: oneOf: - type: string - type: 'null' phoneNumber: oneOf: - type: string - type: 'null' email: oneOf: - type: string - type: 'null' required: - id - firstName - lastName - phoneNumber - email PublicAppointmentVehicleV1ResponseDto: type: object properties: id: type: string format: uuid year: type: number make: type: string model: type: string vin: oneOf: - type: string - type: 'null' mileage: oneOf: - type: number - type: 'null' required: - id - year - make - model - vin - mileage PublicAppointmentDepartmentV1ResponseDto: type: object properties: id: type: string name: oneOf: - type: string - type: 'null' required: - id - name PublicAppointmentAdvisorV1ResponseDto: type: object properties: id: oneOf: - type: string description: Opaque advisor ID, any, or null when not recorded - type: 'null' name: oneOf: - type: string - type: 'null' required: - id - name PublicAppointmentTransportV1ResponseDto: type: object properties: id: type: string name: oneOf: - type: string - type: 'null' required: - id - name PublicAppointmentServiceV1ResponseDto: type: object properties: id: type: string format: uuid name: type: string comments: oneOf: - type: string - type: 'null' required: - id - name - comments securitySchemes: oauth2: type: oauth2 flows: clientCredentials: tokenUrl: https://auth.sparkserv.com/oauth/token scopes: appointments:update: appointments:update appointments:cancel: appointments:cancel dealerships:read: dealerships:read scheduling:read: scheduling:read customers:read: customers:read appointments:read: appointments:read appointments:create: appointments:create ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.