> ## Documentation Index > Fetch the complete documentation index at: https://docs.energy.nayax.com/llms.txt > Use this file to discover all available pages before exploring further. # List a driver's vehicles > Lists the non-archived vehicles associated with a driver. Vehicles hold no driver reference — the association is derived from the driver's tokens' `vehicleId` links. When the access token carries a network claim, the result is scoped to that network. ## OpenAPI ````yaml /api/specs/identity-api.json get /identity/v2/vehicles openapi: 3.0.0 info: title: Lynkwell API version: 1.404.0 description: API Documentation for identity service servers: - url: https://api.lynkwell.com security: [] tags: [] paths: /identity/v2/vehicles: get: tags: - Vehicle summary: List a driver's vehicles description: | Lists the non-archived vehicles associated with a driver. Vehicles hold no driver reference — the association is derived from the driver's tokens' `vehicleId` links. When the access token carries a network claim, the result is scoped to that network. parameters: - in: query name: driverId schema: type: string required: true description: The driver whose vehicles to list responses: '200': description: The driver's vehicles. content: application/json: schema: type: object required: - data properties: data: type: array items: $ref: '#/components/schemas/Vehicle' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/IdentityBadRequestError' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/DefaultUnauthorizedError' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/IdentityDefaultForbiddenError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/IdentityInternalServerError' security: - oauth2: - read:token components: schemas: Vehicle: type: object properties: id: type: string network: type: string description: The network the vehicle belongs to. make: type: string nullable: true model: type: string nullable: true year: type: integer nullable: true vin: type: string nullable: true description: >- Raw VIN, stored as-is (uppercased). Nulled when the vehicle is archived. name: type: string nullable: true description: Driver-facing display name. status: type: string enum: - ACTIVE - IDLE_NOTICE_30_DAYS - IDLE_NOTICE_60_DAYS - IDLE_74_DAYS - DISABLED description: >- Inactivity lifecycle status, measured from last use: warning notices at 30 and 60 days, IDLE_74_DAYS at 74 days (tokens no longer authorize charging), DISABLED at 180 days (vehicle deleted: archived with its tokens, VID freed). Use or re-confirmation resets to ACTIVE. lastUsedAt: type: string format: date-time description: Last time a session started on a linked token. isArchived: type: boolean createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - id - network - status - isArchived - createdAt - updatedAt IdentityBadRequestError: type: object description: The response body for a 400 request properties: type: type: string enum: - BAD_REQUEST code: type: string enum: - INVALID_REQUEST_PARAMETERS - NETWORK_NOT_ENROLLED - INVITE_CODE_FOUND - CONTACT_DETAILS_ALREADY_EXISTS - TOKEN_ALREADY_EXISTS - INACTIVE_SITEHOST_STATUS - INACTIVE_INVITE_CODE - NOT_SITE_HOST - INVITATION_ALREADY_RESOLVED - DRIVER_ALREADY_ATTACHED - TOKEN_IS_ARCHIVED - DRIVER_IS_ARCHIVED - INACTIVE_SUBSCRIPTION - PENDING_INVOICE_ITEMS - UNSUCCESSFUL_JUNCTION_DETACHMENT message: type: string DefaultUnauthorizedError: type: object description: The response body for a 401 request properties: type: type: string enum: - UNAUTHORIZED code: type: string enum: - UNAUTHORIZED message: type: string IdentityDefaultForbiddenError: type: object description: The response body for a 403 request properties: message: type: string IdentityInternalServerError: type: object description: The response body for a 500 request properties: type: type: string enum: - INTERNAL_ERROR code: type: string enum: - INTERNAL_SERVER_ERROR message: type: string securitySchemes: oauth2: type: oauth2 description: OAuth2 Client Credentials Flow flows: clientCredentials: tokenUrl: https://lynkwell-prod.us.auth0.com/oauth/token scopes: read:asset: Retrieve assets write:asset: Create and update assets read:assetgroup: Retrieve asset groups write:assetgroup: Create and update asset groups read:assetstatus: Retrieve asset statuses read:chargingstationmodel: Retrieve charging station models write:chargingstationmodel: Create and update charging station models write:network: Create and update networks write:sitepartner: Create and update site partners read:sitepartner: Retrieve site partners write:sitepartneruser: Create and update site partner users read:sitepartneruser: Retrieve site partner users read:networkaccessprofile: Retrieve network access profiles write:paymentprofile: Create payment profile write:onboardinglink: Create an onboarding link read:invoice: Retrieve an invoice write:session: Create or update a session read:session: Retrieve a session write:ticket: Create a ticket write:verificationcode: Send and confirm verification codes write:driver: Create and update drivers read:driver: Retrieve drivers write:token: Create and update tokens read:token: Retrieve tokens read:tokenvalue: Retrieve token by ID including its value write:invitecode: Create and update invite codes write:invitation: Create and update invitations read:invitation: Retrieve invitations read:payment_terminals_payment: Read payments from payment terminal abort:session: Abruptly end session read:paymentprofile: Retrieve payment profile from payment terminal write:ocpp: Sends request over OCPP write:ocpp.raw_request: Sends raw request over OCPP write:notification.email: Create and update email read:invoiceitem: Retrieve invoice item read:subscription: Retrieve subscription write:plugandcharge_enrollment: Update Plug and Charge enrollment status write:projects: Create and update projects read:projects: Retrieve projects write:project_stations: Create and update project stations write:panel: Create and update panels. read:panel: Retrieve panels. write:webhooks: Create, update, and delete webhooks read:webhooks: Retrieve webhooks read:incident: Retrieve incidents and their sub-resources write:incident: Create, update, comment on, merge, split, and link incidents ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.