> ## Documentation Index > Fetch the complete documentation index at: https://docs.withterminal.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Driver > Get the details of a specific driver ## OpenAPI ````yaml GET /drivers/{id} openapi: 3.1.0 info: title: Terminal Telematics API description: >- Terminal is a unified API that makes it easy to integrate with the leading telematics service providers. version: '0.0' contact: name: Terminal email: connect@withterminal.com url: https://www.withterminal.com servers: - url: https://api.withterminal.com/tsp/v1 description: Production - url: https://api.sandbox.withterminal.com/tsp/v1 description: Sandbox security: - Authorization: [] tags: - name: Authentication - name: Connections - name: Data Management - name: Drivers - name: Groups - name: Hours of Service - name: IFTA - name: Issues - name: Link - name: Providers - name: Safety - name: Trailers - name: Vehicles - name: Vehicle Utilization - name: Webhook Events paths: /drivers/{id}: parameters: - schema: title: DriverId description: Unique identifier for the driver in Terminal. type: string format: ulid pattern: ^drv_[0-9A-HJKMNP-TV-Z]{26}$ example: drv_01D8ZQFGHVJ858NBF2Q7DV9MNC name: id in: path required: true get: tags: - Drivers summary: Get Driver description: Get the details of a specific driver operationId: getDriver parameters: - name: X-Application-Id in: header required: false description: >- Scopes the request to a Terminal application in the caller's organization. Required for multi-application organizations when using a user session or OAuth access token. API keys are already bound to a single application. schema: type: string - name: Connection-Token in: header required: true schema: type: string example: con_tkn_22vUhkC6tgre4kwaYfUkCDA1rzn6eyb4 pattern: ^con_tkn_\S+$ description: >- The token returned when a user authenticated their account. This authorizes access to a specific account. - name: raw in: query required: false schema: type: boolean description: >- Include raw responses used to normalize model. Used for debugging or accessing unique properties that are not unified. - schema: type: string enum: - groups in: query name: expand description: Expand resources in the returned response responses: '200': description: OK content: application/json: schema: title: Driver type: object additionalProperties: false x-model-category: entity examples: [] properties: id: title: DriverId description: Unique identifier for the driver in Terminal. type: string format: ulid pattern: ^drv_[0-9A-HJKMNP-TV-Z]{26}$ example: drv_01D8ZQFGHVJ858NBF2Q7DV9MNC sourceId: title: SourceId type: string example: '123456789' description: The ID used to represent the entity in the source system. provider: title: Provider Code type: string example: geotab description: >- Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). status: type: string enum: - active - inactive example: active description: The status in the providers system firstName: type: string example: Mike middleName: type: string example: Bryan lastName: type: string example: Miller email: type: string format: email example: driver@example.com phone: title: Phone type: string pattern: ^\+?\d{10,14}$ example: '+19058084567' description: >- Phone number formatted in [E.164](https://www.twilio.com/docs/glossary/what-e164) formatting username: type: string description: The driver's username for login purposes example: driver123 license: type: object properties: state: title: State type: string enum: - AL - AK - AS - AZ - AR - CA - CO - CT - DE - FL - GA - GU - HI - ID - IL - IN - IA - KS - KY - LA - ME - MD - MA - MI - MN - MP - MS - MO - MT - NE - NV - NH - NJ - NM - NY - NC - ND - OH - OK - OR - PA - PR - RI - SC - SD - TN - TX - UT - VT - VA - WA - WV - WI - WY - VI - AB - BC - MB - NB - NL - NS - 'ON' - PE - QC - SK - NT - NU - UM - YT - DC example: TN description: US State or Canadian Province number: type: string example: 123-456-789-0 groups: type: array items: example: group_01D8ZQFGHVJ858NBF2Q7DV9MNC oneOf: - title: GroupId type: string format: ulid example: group_01D8ZQFGHVJ858NBF2Q7DV9MNC - title: Expanded Group type: object properties: id: title: GroupId type: string format: ulid example: group_01D8ZQFGHVJ858NBF2Q7DV9MNC required: - id description: >- Entities in Terminal are expandable. Using the `expand` query parameter you can choose to ingest just an ID or the full entity details. createdAt: title: SourceCreatedAt type: string format: date-time description: >- The date and time the record was created in the provider's system. This timestamp comes directly from the source system and represents when the data was originally created there. Note: not all providers expose this. updatedAt: title: SourceUpdatedAt type: string format: date-time description: >- The date and time the record was updated in the provider's system. This timestamp comes directly from the source system and represents when the data was last updated there. Note: not all providers expose this. metadata: title: CoreEntityMetadata type: object description: Internal metadata about the record. required: - addedAt - modifiedAt properties: addedAt: title: AddedAt type: string format: date-time description: >- The date and time the record was ingested into Terminal. Note: this is not the date and time the record was created in the provider's system. modifiedAt: title: ModifiedAt type: string format: date-time description: >- The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. deletedAt: title: DeletedAt type: string format: date-time description: >- The date and time the record was deleted from Terminal. Note: this is not the date and time the record was deleted in the provider's system. visibility: type: string enum: - visible - hidden_by_exclude_list - hidden_by_include_list - hidden_by_status - deleted example: visible description: >- Visibility status of a resource. Read more about hidden records [here](https://docs.withterminal.com/guides/filtering). raw: title: RawDataList type: array example: [] items: title: RawData type: object properties: provider: type: string schema: type: string extractedAt: type: string data: type: object required: - provider - schema - extractedAt - data required: - id - sourceId - provider - status - metadata x-description: The model representing a driver in Terminal. '400': description: Bad Request content: application/json: schema: type: object properties: code: enum: - bad_request message: type: string example: Invalid request body detail: type: array items: title: ErrorPathDetail type: object properties: message: type: string example: '''vehicleId'' property must be a valid ulid' path: type: string example: '{requestQuery}.vehicleId' suggestion: type: string example: >- Please ensure you submit a valid 'vehicleId' property context: type: object required: - message - path required: - code - message '401': description: Unauthorized content: application/json: schema: type: object properties: code: enum: - unauthorized message: type: string example: Unauthorized Request detail: type: string example: Please ensure you have a valid API key required: - code - message '403': description: Forbidden content: application/json: schema: type: object properties: code: enum: - forbidden message: type: string example: Forbidden Request detail: type: string example: >- Please ensure the connection token matches the resource you are attempting to access. required: - code - message '404': description: Not Found content: application/json: schema: type: object properties: code: enum: - not_found message: type: string example: Resource not found detail: type: string example: 'Could not find resource with ID: 2342342' required: - code - message '429': description: Too Many Requests content: application/json: schema: type: object additionalProperties: true properties: code: enum: - too_many_requests retryAfter: description: The number of seconds to wait before retrying the request type: integer example: 60 message: type: string example: Too Many Requests detail: type: string example: You have exceeded your rate limit. Please try again later. required: - code - message '500': description: Internal Server Error content: application/json: schema: type: object properties: code: enum: - internal_server_error message: type: string example: Internal Server Error detail: type: string example: Something went wrong required: - code - message '504': description: Gateway Timeout Error content: application/json: schema: type: object properties: code: enum: - gateway_timeout message: type: string example: Gateway Timeout required: - code - message components: securitySchemes: Authorization: type: http scheme: bearer ````