{"openapi":"3.0.1","info":{"title":"People","description":"People","version":"v3"},"servers":[{"url":"https://talk.perspio.io/people/v3","description":"AU Region"},{"url":"https://us-talk.perspio.io/people/v3","description":"US Region"}],"paths":{"/{id}":{"get":{"tags":["Drivers"],"summary":"Get Driver","description":"Fetch a single driver (person) by id.","operationId":"getDriver","parameters":[{"name":"id","in":"path","description":"Driver Id","required":true,"schema":{"type":"string","example":"in-dr-000043"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"driverId":{"type":"string","description":"Unique identifier of the driver."},"customerDriverId":{"type":"string","description":"Customer-assigned driver identifier."},"sourceSysDriverId":{"type":"string","description":"Driver identifier from the originating source system."},"driverName":{"type":"string","description":"Driver's display name."},"driverTypeId":{"type":"number","description":"Identifier of the driver type."},"active":{"type":"boolean","description":"Whether the driver is currently active."},"createdBy":{"type":"string","description":"User or system that created the record."},"createdDate":{"type":"string","description":"UTC timestamp when the record was created."},"updatedBy":{"description":"User or system that last modified the record."},"ownedBy":{"description":"Owner of the driver record."},"updatedDate":{"type":"string","description":"UTC timestamp when the record was last modified."},"id":{"type":"string","description":"Unique identifier of this record."},"type":{"type":"string","description":"Record type discriminator."},"correlationId":{"description":"Client-supplied correlation id, echoed back for request tracing."},"_ts":{"type":"number","description":"Store timestamp (Unix epoch seconds) of the last write."}}},"example":{"driverId":"drv-000010","customerDriverId":"cust-drv-987","sourceSysDriverId":"ext-drv-654","driverName":"Alice Williams","driverTypeId":2,"active":true,"createdBy":"system-admin","createdDate":"2025-06-25T10:00:00.0000000+00:00","updatedBy":"fleet-manager","ownedBy":"logistics-dept","updatedDate":"2025-06-26T12:30:00.0000000+00:00","id":"drv-000010-uuid-4321","type":"Driver","correlationId":"corr-20250625-100000-xyz123","_ts":1761600000}}}},"400":{"description":"Invalid Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.People.DriverMasterApi.GetDriverInfoById","errorType":"ArgumentException","statusCode":400,"request":"GET /api/people/in-dr-000043","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Invalid people id format: 'abc123'. Expected format: xx-dr-nnnnnn"}}}},"401":{"description":"Invalid API Key provided or Invalid Access token"},"404":{"description":"Driver Not Found"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.People.DriverMasterApi.GetDriverInfoById","errorType":"NullReferenceException","statusCode":500,"request":"GET /api/people/in-dr-000043","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}}},"/":{"get":{"tags":["Drivers"],"summary":"Get Drivers","description":"List the tenant's drivers (people records).","operationId":"getDrivers","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"driverId":{"type":"string","description":"Unique identifier of the driver."},"customerDriverId":{"type":"string","description":"Customer-assigned driver identifier."},"sourceSysDriverId":{"type":"string","description":"Driver identifier from the originating source system."},"driverName":{"type":"string","description":"Driver's display name."},"driverTypeId":{"type":"number","description":"Identifier of the driver type."},"active":{"type":"boolean","description":"Whether the driver is currently active."},"createdBy":{"type":"string","description":"User or system that created the record."},"createdDate":{"type":"string","description":"UTC timestamp when the record was created."},"updatedBy":{"description":"User or system that last modified the record."},"ownedBy":{"description":"Owner of the driver record."},"updatedDate":{"type":"string","description":"UTC timestamp when the record was last modified."},"id":{"type":"string","description":"Unique identifier of this record."},"type":{"type":"string","description":"Record type discriminator."},"correlationId":{"description":"Client-supplied correlation id, echoed back for request tracing."},"_ts":{"type":"number","description":"Store timestamp (Unix epoch seconds) of the last write."}}}},"example":[{"driverId":"drv-000001","customerDriverId":"cust-drv-123","sourceSysDriverId":"ext-drv-456","driverName":"John Doe","driverTypeId":1,"active":true,"createdBy":"admin","createdDate":"2025-01-10T10:15:30.0000000+00:00","updatedBy":"admin","ownedBy":"ops-team","updatedDate":"2025-02-10T12:00:00.0000000+00:00","id":"drv-000001-uuid-1234","type":"Driver","correlationId":"corr-20250110-101530-abc123","_ts":1739000001},{"driverId":"drv-000002","customerDriverId":"cust-drv-124","sourceSysDriverId":"ext-drv-457","driverName":"Jane Smith","driverTypeId":2,"active":false,"createdBy":"system","createdDate":"2025-01-12T08:00:00.0000000+00:00","updatedBy":"manager","ownedBy":"logistics-team","updatedDate":"2025-02-15T09:30:00.0000000+00:00","id":"drv-000002-uuid-5678","type":"Driver","correlationId":"corr-20250112-080000-xyz789","_ts":"17391023_"}]}}},"400":{"description":"Invalid Request"},"401":{"description":"Invalid API Key provided or Invalid Access token"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.People.DriverMasterApi.GetDrivers","errorType":"NullReferenceException","statusCode":500,"request":"GET /api/people","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}}}},"components":{"schemas":{"PerspioError":{"type":"object","properties":{"functionName":{"type":"string","description":"Name of the backend function that raised the error."},"errorType":{"type":"string","description":"Exception/error type name."},"statusCode":{"type":"integer","description":"HTTP status code of the error.","format":"int32"},"request":{"type":"string","description":"Method and URL of the failing request."},"tenantId":{"type":"string","description":"Tenant the request was executed for."},"message":{"type":"string","description":"Human-readable error message."}},"description":"Standard Perspio backend error body (ErrorResultObject emitted by the error-handling middleware)."}},"securitySchemes":{"oauth2":{"type":"oauth2","description":"Client credentials from your Perspio API application. See Get Access Token.","flows":{"clientCredentials":{"tokenUrl":"/auth/v3/token","scopes":{}}}},"subscriptionKey":{"type":"apiKey","name":"Ocp-Apim-Subscription-Key","in":"header","description":"Your tenant's subscription key, from your API application."},"tenantId":{"type":"apiKey","name":"tid","in":"header","description":"Your tenant ID (tid), from your API application."}}},"security":[{"oauth2":[],"subscriptionKey":[],"tenantId":[]}],"tags":[{"name":"Drivers","description":"Driver (people) records."}],"x-readme":{"oauth-options":{"useInsecureClientAuthentication":true}}}