{
  "success": true,
  "data": {
    "companies": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Acme Corporation",
        "legal_name": "Acme Corporation Inc.",
        "guru_permalink": "acme-corporation",
        "domain": "acme.com",
        "region": "San Francisco Bay Area",
        "short_description": "<string>",
        "long_description": "<string>",
        "num_employees": "11-50",
        "linkedin": "<string>",
        "twitter": "<string>",
        "facebook": "<string>",
        "pitchbook": "<string>",
        "crunchbase": "<string>",
        "address": "<string>",
        "ipo_status": "private",
        "num_funding_rounds": 11,
        "num_investors": 14,
        "total_raised": 2834940000,
        "latest_valuation_usd": 31000000000,
        "latest_valuation_date": "2017-03-09T00:00:00.000Z",
        "industries": [
          {
            "permalink": "artificial-intelligence",
            "name": "Artificial Intelligence"
          }
        ],
        "location": {
          "region": {
            "name": "San Francisco Bay Area",
            "permalink": "san-francisco-bay-area"
          },
          "country": {
            "name": "United States",
            "permalink": "united-states"
          },
          "state": {
            "name": "California",
            "permalink": "california"
          },
          "city": {
            "name": "San Francisco",
            "permalink": "san-francisco-california"
          }
        },
        "latest_deal": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "type": "SERIES_B",
          "total_round_raised": 25000000,
          "date": "2024-01-15T00:00:00Z",
          "extension": false,
          "pre": false,
          "intermediate": "NONE",
          "description": {
            "short_description": "<string>",
            "long_description": "<string>"
          },
          "investors": [
            "c5a3f6ac-f6c9-4686-aa6e-12aeb7419b82",
            "c6bc63af-cb37-453d-9c20-35f56fb87ee9"
          ],
          "angel_investor_ids": [
            "b3e9c7d1-2f4a-4d5e-9c1b-7a8f3e2d1c6a"
          ],
          "financings": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "type": "<string>",
              "size_usd": 25000000,
              "size_native": 25000000,
              "currency": "USD"
            }
          ]
        },
        "all_investor_ids": [
          "c5a3f6ac-f6c9-4686-aa6e-12aeb7419b82",
          "c6bc63af-cb37-453d-9c20-35f56fb87ee9"
        ],
        "similarity": null
      }
    ]
  },
  "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": "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": "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>"
  }
}