> ## 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 > Retrieve detailed information about a single venture capital deal by its unique identifier ## OpenAPI ````yaml openapi/openapi-deals.yaml GET /deals/{id} 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}: get: summary: Get a specific deal by ID description: >- Retrieve detailed information about a single venture capital deal by its unique identifier operationId: getDealById 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 data content: application/json: schema: type: object properties: success: type: boolean example: true data: type: object properties: deal: $ref: '#/components/schemas/Deal' 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 or unsupported query parameters content: application/json: schema: oneOf: - type: object properties: success: type: boolean example: false error: type: object properties: code: type: string example: INVALID_DEAL_ID message: type: string example: Deal ID must be a valid UUID details: type: object properties: help: type: string example: >- Please provide a valid UUID format for the deal ID statusCode: type: integer example: 400 - type: object properties: success: type: boolean example: false error: type: object properties: code: type: string example: INVALID_PARAMETERS message: type: string example: >- Query parameters are not supported for this endpoint details: type: object properties: providedParameters: type: array items: type: string example: - page - sort_by help: type: string example: >- This endpoint only accepts a deal ID in the path. Remove all query parameters. statusCode: type: integer example: 400 '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 details: type: object properties: help: type: string example: Please check the deal ID and try again statusCode: type: integer example: 404 '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: Deal: type: object properties: id: type: string format: uuid description: Unique identifier for the deal example: 550e8400-e29b-41d4-a716-446655440000 round_type: type: string nullable: true description: Type of funding round enum: - SERIES_A - SERIES_B - SERIES_C - SERIES_D - SERIES_E - SERIES_F - SERIES_G - SERIES_H - SERIES_I - SERIES_J - SERIES_K - SERIES_L - SERIES_M - SEED - SAFE - CONVERTIBLE_NOTE - EQUITY - PREFERRED - SECONDARY_MARKET - DEBT_FINANCING - GRANT - NON_EQUITY_ASSISTANCE - CROWDFUNDING - INITIAL_COIN_OFFERING - FUNDING_ROUND example: SERIES_A extension: type: boolean nullable: true description: Whether this is an extension round example: false intermediate: type: string nullable: true description: Intermediate round designation enum: - PLUS - NONE - ONE - TWO - THREE - FOUR - FIVE - SIX - SEVEN - EIGHT example: NONE pre: type: boolean nullable: true description: Whether this is a pre-round (e.g., Pre-Series A) example: false date: type: string format: date-time nullable: true description: Announcement date of the funding round example: '2024-01-15T00:00:00Z' created_at: type: string format: date-time nullable: true description: Date the deal was added to the system example: '2024-01-16T12:30:00Z' total_round_raised: type: number nullable: true description: Total amount raised in the round (USD) example: 25000000 deal_descriptions: type: object nullable: true properties: short_description: type: string nullable: true description: Brief description of the deal long_description: type: string nullable: true description: Detailed description of the deal company_id: type: string format: uuid description: Unique identifier for the company example: 550e8400-e29b-41d4-a716-446655440001 investor_ids: type: array description: >- UUIDs of firm investors participating in this deal. Angels are surfaced separately in `angel_investor_ids`. items: type: string format: uuid example: - c5a3f6ac-f6c9-4686-aa6e-12aeb7419b82 angel_investor_ids: type: array description: >- UUIDs of angel investors (people) who participated in this deal. Resolve via `/people/{id}`. Empty array when no angels. items: type: string format: uuid example: - b3e9c7d1-2f4a-4d5e-9c1b-7a8f3e2d1c6a financings: type: array description: >- Detailed financing information for deals that have multiple financing types items: $ref: '#/components/schemas/Financing' valuation: $ref: '#/components/schemas/Valuation' nullable: true description: Valuation information for this deal articles: type: array description: > Related articles/sources for this deal. Only included for Enterprise (API tier) users. Omitted entirely for other tiers. items: $ref: '#/components/schemas/DealArticle' required: - id - company_id - investor_ids - angel_investor_ids - financings 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 Financing: type: object properties: id: type: string format: uuid description: Unique identifier for the financing type: type: string description: Type of financing enum: - SEED - SERIES_A - SERIES_B - SERIES_C - SERIES_D - SERIES_E - SERIES_F - SERIES_G - SERIES_H - SERIES_I - SERIES_J - SERIES_K - SERIES_L - SERIES_M - CONVERTIBLE_NOTE - CROWDFUNDING - DEBT_FINANCING - EQUITY - FUNDING_ROUND - GRANT - INITIAL_COIN_OFFERING - NON_EQUITY_ASSISTANCE - PREFERRED - SAFE - SECONDARY_MARKET example: SERIES_A size_usd: type: number nullable: true description: Financing amount (USD) example: 25000000 size_native: type: number nullable: true description: Financing amount in native currency example: 25000000 currency: type: string nullable: true description: Currency of the original financing amount example: USD required: - id - type Valuation: type: object nullable: true properties: valuation_currency: type: string nullable: true description: Currency of the valuation example: USD valuation_usd: type: number nullable: true description: Valuation amount (USD) example: 100000000 valuation_native: type: number nullable: true description: Valuation amount in native currency example: 100000000 type: type: string description: Type of valuation enum: - DEFAULT - POST_MONEY - PRE_MONEY example: POST_MONEY required: - type DealArticle: type: object description: An article or source related to a deal (Enterprise/API tier only) properties: link: type: string nullable: true description: URL of the article example: https://techcrunch.com/2024/01/15/company-raises-series-a date: type: string nullable: true description: Date of the article example: '2024-01-15' is_primary: type: boolean description: Whether this is the primary source article for the deal example: true required: - is_primary 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]` ````