> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryfundable.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Deal Investors > Retrieve detailed investor information for a single deal, including lead status, personnel, and investor profile links. ## OpenAPI ````yaml openapi/openapi-deals.yaml GET /deals/{id}/investors openapi: 3.0.3 info: title: Fundable Deals API description: > API for accessing venture capital deals data with advanced filtering capabilities. ## Authentication All API requests require authentication using an API key in the Authorization header. ## Rate Limits API usage is tracked and may be subject to monthly limits depending on your API key tier. ## Request Body Structure Send a JSON body with up to 4 filter sections plus pagination/sort at the top level: - `identifiers` - Look up specific deals by UUID - `deal` - Filter by deal attributes (financing type with pre/extension modifiers, size, date) - `company` - Filter by company attributes (location, industry, size, IPO status) - `investors` - Filter by investor participation (firms or people, by UUID) ## Parameter Validation This API enforces strict parameter validation: - **Unknown Fields**: Any field not in the allowed list will result in a `422 UNKNOWN_PARAMETER` error - **Enum Values**: Parameters like `financing_types`, `sort_by`, `employee_count`, and `ipo_status` only accept exact enum values - **Data Types**: Numeric parameters must be valid numbers, dates must be valid ISO 8601 format - **Array Parameters**: Cannot be empty arrays; provide values or omit entirely ## Validation Errors Invalid parameters return detailed error responses with: - Specific error codes (e.g., `INVALID_FINANCING_TYPE`, `UNKNOWN_PARAMETER`) - Clear error messages explaining what's wrong - Valid options for enum parameters - Help text and documentation links version: 2.0.0 contact: name: Fundable API Support url: jacob@tryfundable.ai license: name: Proprietary url: https://www.tryfundable.ai/terms/privacy/ servers: - url: https://www.tryfundable.ai/api/v1 description: Production server security: - bearerAuth: [] tags: - name: deals description: Venture capital deals data paths: /deals/{id}/investors: get: summary: Get investors for a specific deal description: >- Retrieve detailed investor information for a single deal, including lead status, personnel, and investor profile links. operationId: getDealInvestors parameters: - name: id in: path description: Unique identifier for the deal (UUID format) required: true schema: type: string format: uuid example: 4b20cafe-c22b-441a-8378-53436e1d9edf responses: '200': description: Successful response with deal investors content: application/json: schema: type: object properties: success: type: boolean example: true data: type: object properties: investors: type: array description: >- Firm investors on this deal. Angels are surfaced separately in `angel_investors`. items: $ref: '#/components/schemas/DealInvestor' angel_investors: type: array description: >- Angel investors (individuals) on this deal. Empty array when no angels. items: $ref: '#/components/schemas/AngelInvestor' required: - investors - angel_investors meta: type: object properties: page: type: integer example: 0 page_size: type: integer example: 1 credits_used: type: integer description: Number of credits consumed by this request example: 1 credit_source: type: string nullable: true enum: - monthly - purchased description: >- Source of credits used (only included for non-API tier keys) example: monthly monthly_credits_remaining: type: integer nullable: true description: >- Remaining monthly credits (only included for non-API tier keys) example: 990 purchased_credits_remaining: type: integer nullable: true description: >- Remaining purchased credits (only included for non-API tier keys) example: 500 required: - success - data - meta '400': description: Bad Request - Invalid deal ID format content: application/json: schema: $ref: '#/components/schemas/ValidationError' '401': description: Authentication error content: application/json: schema: $ref: '#/components/schemas/AuthError' '402': description: Insufficient credits to complete request content: application/json: schema: $ref: '#/components/schemas/InsufficientCreditsError' '404': description: Deal not found content: application/json: schema: type: object properties: success: type: boolean example: false error: type: object properties: code: type: string example: DEAL_NOT_FOUND message: type: string example: Deal not found '429': description: Rate limit exceeded (per-minute) content: application/json: schema: $ref: '#/components/schemas/RateLimitError' headers: Retry-After: description: Number of seconds to wait before retrying schema: type: integer example: 60 '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ServerError' components: schemas: DealInvestor: type: object description: >- A firm investor on a deal. Angels are returned separately in the `angel_investors` array on /deals/{id}/investors. properties: id: type: string format: uuid description: Unique identifier for the firm investor (parent_investor UUID) example: c5a3f6ac-f6c9-4686-aa6e-12aeb7419b82 name: type: string description: Investor name example: Sequoia Capital lead_investor: type: boolean nullable: true description: Whether this investor led the round example: true personnel: type: array description: >- Key personnel (partners) at this firm involved in this deal. Each entry is a person record joinable to /people/{id}. items: $ref: '#/components/schemas/PersonnelMember' example: - id: f1a2b3c4-d5e6-7890-abcd-ef1234567890 name: John Smith linkedin: https://linkedin.com/in/johnsmith crunchbase: https://crunchbase.com/person/john-smith twitter: https://x.com/johnsmith financing_type: type: string nullable: true description: The financing type this investor participated in example: SERIES_A domain: type: string nullable: true description: Investor's website domain example: sequoiacap.com linkedin: type: string nullable: true description: Investor's LinkedIn URL example: https://linkedin.com/company/sequoia-capital crunchbase: type: string nullable: true description: Investor's Crunchbase URL example: https://crunchbase.com/organization/sequoia-capital required: - id - name AngelInvestor: type: object description: >- An angel (individual) investor on a deal. Returned in the `angel_investors` array on /deals/{id}/investors. properties: id: type: string format: uuid description: Person UUID for the angel. Resolves via /people/{id}. name: type: string nullable: true financing_type: type: string nullable: true description: The financing type this angel participated in. example: SEED linkedin: type: string nullable: true crunchbase: type: string nullable: true twitter: type: string nullable: true required: - id ValidationError: type: object properties: error: type: object properties: code: type: string enum: - VALIDATION_ERROR example: VALIDATION_ERROR message: type: string example: Invalid request parameters details: type: object properties: errors: type: array items: type: object properties: field: type: string description: The parameter name that failed validation example: deal.financing_types value: type: string description: The invalid value provided example: series-a message: type: string description: Human-readable error message example: >- Invalid financing type(s): series-a. Valid options are: SERIES_A, SERIES_B, SEED, ... code: type: string description: Machine-readable error code example: INVALID_FINANCING_TYPE validOptions: type: array items: type: string description: List of valid values for enum parameters example: - SERIES_A - SERIES_B - SEED help: type: string example: >- Please check your request parameters and ensure they meet the required format and constraints. required: - error AuthError: type: object properties: error: type: object properties: code: type: string enum: - AUTH_ERROR - INVALID_API_KEY - INACTIVE_API_KEY example: AUTH_ERROR message: type: string example: API key not provided details: type: object properties: help: type: string example: Please provide your API key in the Authorization header format: type: string example: Bearer vg_your_api_key_here required: - error InsufficientCreditsError: type: object properties: success: type: boolean example: false error: type: object properties: code: type: string example: INSUFFICIENT_CREDITS message: type: string example: >- Not enough credits to complete this request. Visit https://www.tryfundable.ai/api-access to purchase more. details: type: object properties: credits_needed: type: integer nullable: true description: >- Number of credits required (included when known post-execution) example: 25 monthly_credits_remaining: type: integer description: Remaining monthly credits example: 0 purchased_credits_remaining: type: integer description: Remaining purchased credits example: 0 help: type: string example: >- Purchase additional credits at https://www.tryfundable.ai/api-access or upgrade your plan. required: - error RateLimitError: type: object properties: success: type: boolean example: false error: type: object properties: code: type: string example: RATE_LIMIT_EXCEEDED message: type: string example: Rate limit exceeded. Maximum 200 requests per minute. details: type: object properties: limit: type: integer description: Maximum requests allowed per window example: 200 window: type: string description: Rate limit window duration example: 60 seconds help: type: string example: Please reduce your request frequency and try again. required: - error ServerError: type: object properties: error: type: object properties: code: type: string example: INTERNAL_SERVER_ERROR message: type: string example: An unexpected error occurred details: type: string nullable: true description: Error details (only in development mode) required: - error PersonnelMember: type: object description: A person (partner) at a firm investor associated with a deal. properties: id: type: string format: uuid description: Person UUID. Resolves via /people/{id}. name: type: string nullable: true linkedin: type: string nullable: true description: LinkedIn URL. crunchbase: type: string nullable: true description: Crunchbase URL. twitter: type: string nullable: true description: Twitter/X URL. required: - id securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: | API key authentication using Bearer token format. Format: `Authorization: Bearer vg_your_api_key_here` API keys follow the pattern: `vg_[12_hex_chars]_[32_base64url_chars]` ````