{
  "success": true,
  "data": {
    "deals": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "company_id": "550e8400-e29b-41d4-a716-446655440001",
        "investor_ids": [
          "c5a3f6ac-f6c9-4686-aa6e-12aeb7419b82"
        ],
        "angel_investor_ids": [
          "b3e9c7d1-2f4a-4d5e-9c1b-7a8f3e2d1c6a"
        ],
        "financings": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "type": "SERIES_A",
            "size_usd": 25000000,
            "size_native": 25000000,
            "currency": "USD"
          }
        ],
        "round_type": "SERIES_A",
        "extension": false,
        "intermediate": "NONE",
        "pre": false,
        "date": "2024-01-15T00:00:00Z",
        "created_at": "2024-01-16T12:30:00Z",
        "total_round_raised": 25000000,
        "deal_descriptions": {
          "short_description": "<string>",
          "long_description": "<string>"
        },
        "valuation": {
          "type": "POST_MONEY",
          "valuation_currency": "USD",
          "valuation_usd": 100000000,
          "valuation_native": 100000000
        },
        "articles": [
          {
            "is_primary": true,
            "link": "https://techcrunch.com/2024/01/15/company-raises-series-a",
            "date": "2024-01-15"
          }
        ]
      }
    ]
  },
  "meta": {
    "total_count": 1547,
    "page": 0,
    "page_size": 10,
    "credits_used": 10,
    "credit_source": "monthly",
    "monthly_credits_remaining": 990,
    "purchased_credits_remaining": 500
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": {
      "errors": [
        {
          "field": "deal.financing_types",
          "value": "series-a",
          "message": "Invalid financing type(s): series-a. Valid options are: SERIES_A, SERIES_B, SEED, ...",
          "code": "INVALID_FINANCING_TYPE",
          "validOptions": [
            "SERIES_A",
            "SERIES_B",
            "SEED"
          ]
        }
      ],
      "help": "Please check your request parameters and ensure they meet the required format and constraints."
    }
  }
}

{
  "error": {
    "code": "AUTH_ERROR",
    "message": "API key not provided",
    "details": {
      "help": "Please provide your API key in the Authorization header",
      "format": "Bearer vg_your_api_key_here"
    }
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits to complete this request. Visit https://www.tryfundable.ai/api-access to purchase more.",
    "details": {
      "credits_needed": 25,
      "monthly_credits_remaining": 0,
      "purchased_credits_remaining": 0,
      "help": "Purchase additional credits at https://www.tryfundable.ai/api-access or upgrade your plan."
    }
  },
  "success": false
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": {
      "errors": [
        {
          "field": "deal.financing_types",
          "value": "series-a",
          "message": "Invalid financing type(s): series-a. Valid options are: SERIES_A, SERIES_B, SEED, ...",
          "code": "INVALID_FINANCING_TYPE",
          "validOptions": [
            "SERIES_A",
            "SERIES_B",
            "SEED"
          ]
        }
      ],
      "help": "Please check your request parameters and ensure they meet the required format and constraints."
    }
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Maximum 200 requests per minute.",
    "details": {
      "limit": 200,
      "window": "60 seconds",
      "help": "Please reduce your request frequency and try again."
    }
  },
  "success": false
}

{
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "An unexpected error occurred",
    "details": "<string>"
  }
}