> ## Documentation Index > Fetch the complete documentation index at: https://docs.tavrn.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Requestor > Read a Requestor profile. Requires requestors:read. An unavailable ID returns 404. ## OpenAPI ````yaml GET /v2/requestors/{requestor_id} openapi: 3.0.1 info: title: Tavrn Platform API version: 1.0.0 description: >- Enterprise API for medical record retrieval: cases, retrieval requests, retrieved records and provider invoices, case documents, and webhook notifications. contact: name: Tavrn Support email: contact@tavrn.ai servers: - url: https://enterprise.tavrn.ai description: Production server security: - bearerAuth: [] tags: - name: Cases description: Case management operations - name: Documents description: Document upload and management - name: Retrieval Requests description: Medical record retrieval requests submitted to healthcare facilities - name: Requestors description: Multiple retrieval profiles within one organization - name: Webhooks description: Webhook registration and event notifications paths: /v2/requestors/{requestor_id}: get: tags: - Requestors summary: Get Requestor description: >- Read a Requestor profile. Requires requestors:read. An unavailable ID returns 404. operationId: getRequestor parameters: - name: requestor_id in: path required: true schema: type: string pattern: ^[a-fA-F0-9]{24}$ example: '111111111111111111111111' responses: '200': description: Profile returned content: application/json: schema: $ref: '#/components/schemas/Requestor' '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Insufficient scope content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Requestor not found in your organization content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Requestor: type: object properties: id: type: string pattern: ^[a-fA-F0-9]{24}$ example: '111111111111111111111111' name: type: string nullable: true description: Name override, or null to use the organization name. is_default: type: boolean description: >- Whether this profile is selected when creation omits both Requestor fields. provider_invoice_limit: type: number minimum: 0 nullable: true description: >- Provider invoice approval limit in USD. Null uses $100; 0 prevents automatic payment of positive provider costs. effective_provider_invoice_limit: type: number minimum: 0 description: Applied approval limit in USD after resolving null to $100. letter_of_rep: type: object nullable: true allOf: - $ref: '#/components/schemas/RequestorFile' rfc_form: type: object nullable: true allOf: - $ref: '#/components/schemas/RequestorFile' affidavits: type: object required: - declared_families - documents - generic - config_revision properties: declared_families: type: array items: type: string enum: - records - billing - radiology documents: type: array items: allOf: - $ref: '#/components/schemas/RequestorFile' - type: object properties: family: type: string enum: - records - billing - radiology source: type: string enum: - FIRM_UPLOAD - TAVRN_DEFAULT required: - family - source generic: type: object nullable: true allOf: - $ref: '#/components/schemas/RequestorFile' config_revision: type: integer nullable: true correspondence: type: object nullable: true allOf: - $ref: '#/components/schemas/RequestorCorrespondence' created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - name - is_default - provider_invoice_limit - effective_provider_invoice_limit - letter_of_rep - rfc_form - affidavits - correspondence - created_at - updated_at Error: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string description: Machine-readable error code example: validation_error message: type: string description: Human-readable error message example: The patient.date_of_birth field is required RequestorFile: type: object required: - file_name - page_count - uploaded_at properties: file_name: type: string nullable: true page_count: type: integer nullable: true uploaded_at: type: string nullable: true format: date-time nullable: true description: Document metadata returned with a Requestor. RequestorCorrespondence: type: object properties: custom_letter_body: type: string nullable: true maxLength: 10000 custom_letter_body_requires_rfc: type: boolean nullable: true notice: type: object nullable: true allOf: - $ref: '#/components/schemas/RequestorCorrespondenceNotice' billing_request: type: object nullable: true allOf: - $ref: '#/components/schemas/RequestorBillingInstructions' additionalProperties: false nullable: true description: >- Omitted settings stay unchanged on update. Null clears nullable settings. A supplied notice replaces the previous notice; supplied billing_request fields merge with existing fields. RequestorCorrespondenceNotice: type: object properties: title: type: string maxLength: 500 body: type: string maxLength: 10000 suppress_prepayment_sentence: type: boolean nullable: true suppress_provider_cost_threshold_paragraph: type: boolean nullable: true required: - title - body additionalProperties: false nullable: true RequestorBillingInstructions: type: object properties: special_instruction: type: string nullable: true maxLength: 10000 cover_letter_ask: type: string nullable: true maxLength: 10000 auth_scope_stamp_label: type: string nullable: true maxLength: 500 additionalProperties: false nullable: true securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- API key authentication. Use format: `Authorization: Bearer tavrn_sk_live_...` ````