--- title: Retrieve a Vet slug: retrieve-a-vet docTags: createdAt: 2026-04-21T15:22:49.957Z --- { "id": "FXxhS8NeoYo1-RrbbL1j_", "type": "api-oas-v2", "data": { "method": "GET", "url": "https://developer.digitail.io/api/v1/vets/{id}", "servers": [ { "url": "https://developer.digitail.io/api/v1/vets/{id}", "description": "Sandbox server (uses test data)" }, { "url": "https://vet.digitail.io/api/v1/vets/{id}", "description": "Production server (uses live data)" } ], "name": "Retrieve a Vet", "description": "

Permissions needed: ACCESS_PATIENTS\nReturns a Vet entity

", "contentType": "application/json", "request": { "pathParameters": [], "headerParameters": [ { "name": "accept", "type": "string", "kind": "optional", "description": "Generated from available response content types", "enum": [ "application/json" ], "default": "application/json" } ], "queryParameters": [ { "kind": "optional", "name": "include", "type": "string", "description": "

Additional relations to include(Ex.: multipleClinic, multipleClinic.rooms, vetRolesAll, services, visitTypes, employees.teams)

" } ], "bodyDataParameters": [], "formDataParameters": [], "oAuthParameters": [ { "id": "passport", "name": "passport", "kind": "optional", "type": "oauth2", "description": "Laravel passport oauth2 security.", "oauth2Flows": { "authorizationCode": { "authorizationUrl": "https://digitail.test/oauth/authorize", "tokenUrl": "https://digitail.test/oauth/token", "refreshUrl": "https://digitail.test/oauth/token" } } }, { "id": "Bearer", "name": "Bearer", "kind": "optional", "type": "http", "scheme": "bearer" } ], "cookieParameters": [] }, "responses": [ { "statusCode": "200", "description": "successful operation", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "description": "", "schema": [ { "name": "data", "kind": "optional", "type": "object", "description": "A vet is the user of the system. A vet is any member of the animal hospital staff that has an account in Digitail. Each user has a specific role in the system and can be associated with multiple clinics.", "example": "", "schema": [ { "name": "id", "kind": "optional", "type": "integer", "description": "", "example": 1 }, { "name": "first_name", "kind": "optional", "type": "string", "description": "", "example": "John" }, { "name": "last_name", "kind": "optional", "type": "string", "description": "", "example": "Doe" }, { "name": "full_name", "kind": "optional", "type": "string", "description": "", "example": "John Doe" }, { "name": "name_with_title", "kind": "optional", "type": "string", "description": "", "example": "Dr. John Doe" }, { "name": "email", "kind": "optional", "type": "string", "description": "", "example": "vet@example.com" }, { "name": "phone", "kind": "optional", "type": "string", "description": "", "example": "123456789" }, { "name": "avatar", "kind": "optional", "type": "string", "description": "", "example": "https://vet.digitail.io/images/profilepic.jpg" }, { "name": "stamp", "kind": "optional", "type": "string", "nullable": true, "description": "", "example": "https://vet.digitail.io/images/signature.jpg" }, { "name": "license_number", "kind": "optional", "type": "string", "nullable": true, "description": "", "example": "123456789" }, { "name": "job_title", "kind": "optional", "type": "string", "description": "", "example": "Dr." }, { "name": "deleted_at", "kind": "optional", "type": "string", "nullable": true, "description": "", "example": "", "format": "date-time" }, { "name": "active", "kind": "optional", "type": "boolean", "description": "", "example": true }, { "name": "video_link", "kind": "optional", "type": "string", "nullable": true, "description": "", "example": "https://digitail.com/video" }, { "name": "public_appointment_link", "kind": "optional", "type": "string", "description": "", "example": "https://digitail.com/clinics/clinic-slug/vet-slug" }, { "name": "type", "kind": "optional", "type": "string", "nullable": true, "description": "", "enum": [ "veterinarian", "technician", "groomer", "practice_manager", "receptionist", "support_staff" ] }, { "name": "two_factor_enabled", "kind": "optional", "type": "boolean", "description": "", "example": true }, { "name": "has_chat_user", "kind": "optional", "type": "boolean", "description": "

true if chatUser is active, false if non-existent or inactive

", "example": true }, { "name": "colleague_order", "kind": "optional", "type": "integer", "nullable": true, "description": "", "example": 1 }, { "name": "is_visible_on_calendar", "kind": "optional", "type": "boolean", "nullable": true, "description": "" }, { "name": "employees", "kind": "optional", "type": "array", "description": "", "example": "", "itemType": "object", "customType": "object[]", "schema": [ { "name": "clinic_id", "kind": "optional", "type": "integer", "description": "" }, { "name": "vet_role_id", "kind": "optional", "type": "integer", "description": "" }, { "name": "is_available_for_appointments", "kind": "optional", "type": "boolean", "description": "" }, { "name": "is_visible_on_calendar", "kind": "optional", "type": "boolean", "description": "" }, { "name": "type", "kind": "optional", "type": "string", "description": "" }, { "name": "teams", "kind": "optional", "type": "array", "nullable": true, "description": "", "modelRef": "#/paths/~1api~1v1~1tasks/get/responses/200/content/application~1json/schema/properties/data/items/properties/team", "customType": "team[]", "schema": [] } ] }, { "name": "teams", "kind": "optional", "type": "array", "nullable": true, "description": "", "modelRef": "#/paths/~1api~1v1~1tasks/get/responses/200/content/application~1json/schema/properties/data/items/properties/team", "customType": "team[]", "schema": [] }, { "name": "visit_types", "kind": "optional", "type": "array", "description": "", "modelRef": "#/paths/~1api~1v1~1records/post/responses/201/content/application~1json/schema/properties/data/properties/visit_types/items", "customType": "items[]", "schema": [] }, { "name": "booking_status", "kind": "optional", "type": "string", "nullable": true, "description": "", "enum": [ "inactive", "staffing_only", "internal_needs_setup", "internal_ready", "online_needs_setup", "online_ready" ] } ] } ], "isExpanded": true } ] } ], "hasXCodeSamples": false, "examples": { "languages": [ { "id": "ZXaSBmbimsn96gyTODaee", "language": "curl", "label": "cURL", "code": "curl --request GET \\\n --url https://developer.digitail.io/api/v1/vets/{id} \\\n --header 'accept: application/json'" }, { "id": "zNv072j7uTlisPtD_6JUY", "language": "javascript", "label": "javascript", "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar requestOptions = {\n method: 'GET',\n headers: myHeaders,\n redirect: 'follow'\n};\n\nfetch(\"https://developer.digitail.io/api/v1/vets/{id}\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));" }, { "id": "wHJ9bTvulAZDvaBw6kuFe", "language": "ruby", "label": "Ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://developer.digitail.io/api/v1/vets/{id}\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\n\nresponse = https.request(request)\nputs response.read_body\n" }, { "id": "W0v4grRZF8b0I68kaMQKV", "language": "python", "label": "Python", "code": "import requests\nimport json\n\nurl = \"https://developer.digitail.io/api/v1/vets/{id}\"\n\npayload = {}\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n" } ], "selectedLanguageId": "ZXaSBmbimsn96gyTODaee" }, "results": { "languages": [ { "id": "f1inTGlLaBwEohECLzdjO", "language": "200", "code": "// successful operation\n{\n \"data\": {\n \"id\": 1,\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"full_name\": \"John Doe\",\n \"name_with_title\": \"Dr. John Doe\",\n \"email\": \"vet@example.com\",\n \"phone\": \"123456789\",\n \"avatar\": \"https://vet.digitail.io/images/profilepic.jpg\",\n \"stamp\": \"https://vet.digitail.io/images/signature.jpg\",\n \"license_number\": \"123456789\",\n \"job_title\": \"Dr.\",\n \"deleted_at\": \"\",\n \"active\": true,\n \"video_link\": \"https://digitail.com/video\",\n \"public_appointment_link\": \"https://digitail.com/clinics/clinic-slug/vet-slug\",\n \"type\": \"\",\n \"two_factor_enabled\": true,\n \"has_chat_user\": true,\n \"colleague_order\": 1,\n \"is_visible_on_calendar\": false,\n \"employees\": [\n {\n \"clinic_id\": 0,\n \"vet_role_id\": 0,\n \"is_available_for_appointments\": false,\n \"is_visible_on_calendar\": false,\n \"type\": \"\",\n \"teams\": [\n \"\"\n ]\n }\n ],\n \"teams\": [\n \"\"\n ],\n \"visit_types\": [\n \"\"\n ],\n \"booking_status\": \"\"\n }\n}" } ], "selectedLanguageId": "f1inTGlLaBwEohECLzdjO" } }, "children": [ { "text": "" } ] }