---
updatedAt: 2026-04-21T17:58:34.000Z
agentTools:
projectIndex: https://docs.bloomberry.com/llms.txt
---
# Get current customers
Returns a list of active customers that is subscribed to a specific tech vendor OR to ANY tech vendor in a specific category
Need an API key? Get a free API key here
# OpenAPI definition
```json
{
"openapi": "3.0.3",
"info": {
"title": "B2B Tech Stack Intelligence API",
"description": "Comprehensive API for retrieving tech stack changes, active customer lists for a vendor, and hiring signals (job postings)",
"version": "1.0.0",
"contact": {
"url": "https://bloomberry.com"
}
},
"servers": [
{
"url": "https://api.revealera.com",
"description": "Production server"
}
],
"security": [
{
"ApiKeyAuth": []
}
],
"paths": {
"/accounts/tech.json": {
"get": {
"summary": "Get current customers",
"description": "Returns a list of active customers that is subscribed to a specific tech vendor OR to ANY tech vendor in a specific category \nNeed an API key? Get a free API key here ",
"tags": [
"Active Customer Lists"
],
"security": [
{
"ApiKeyAuth": []
}
],
"parameters": [
{
"name": "next_token",
"in": "query",
"description": "Pagination token from previous response (located in \"pagination\" > \"next_token\") to fetch the next page. Leave blank for the first page",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "companies per page. ",
"required": false,
"schema": {
"type": "integer",
"default": 20,
"minimum": 1,
"maximum": 20
}
},
{
"name": "category",
"in": "query",
"description": "The product category to get active customers for. All possible product categories are available at https://api.revealera.com/categories.txt. Pass \"all\" to get customers for all categories. Note: ONLY 1 of category OR vendor_name MUST be specified, but no more than 1.",
"required": false,
"schema": {
"type": "string"
},
"example": "human capital management"
},
{
"name": "vendor_name",
"in": "query",
"description": "The name of the vendor to get current customers for. All possible vendor names can be found here: https://api.revealera.com/vendors.txt . Note: ONLY 1 of category OR vendor_name MUST be specified, but no more than 1.",
"required": false,
"schema": {
"type": "string"
},
"example": "Google Workspace"
},
{
"name": "company_employee_size_range",
"in": "query",
"description": "Only show active customers from companies with number of employees that match the specified size ranges. Possible ranges are 1 employee, 2-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, 10,001+. Separate multiple values with semicolon.",
"required": false,
"schema": {
"type": "string"
},
"example": "2-10;11-50"
},
{
"name": "company_industry",
"in": "query",
"description": "Only show customers from companies in the industry passed in. We look at at the Linkedin company page to determine industries. All possible industries are in https://api.revealera.com/linkedin_industries.txt Separate multiple values with ';' default(all)",
"required": false,
"schema": {
"type": "string"
},
"example": "Software Development;IT Services and IT Consulting"
},
{
"name": "company_country",
"in": "query",
"description": "Only show customers from companies headquartered in the country passed in. The country codes must be in ISO 3166-1 alpha-2 format. Separate multiple values with ';' default(all)",
"required": false,
"schema": {
"type": "string"
},
"example": "US;GB"
},
{
"name": "company_region",
"in": "query",
"description": "Only show customers from companies headquartered in the specified regions. Possible values include: Africa, Asia, Europe, North America, Oceania, South America. Separate multiple values with ';'. default(all)",
"required": false,
"schema": {
"type": "string",
"example": "North America;Europe",
"pattern": "^[A-Z]{2}(;[A-Z]{2})*$"
}
},
{
"name": "omit_linkedin_data",
"in": "query",
"description": "true if you to omit linkedin-related fields from the response (ie for compliance reasons)",
"required": false,
"schema": {
"type": "string",
"default": false
}
},
{
"name": "exclude_domains",
"in": "query",
"description": "Exclude companies with the domains passed in Separate multiple values with semicolon.",
"required": false,
"schema": {
"type": "string",
"example": "logitech.com;starbucks.com"
}
}
],
"responses": {
"200": {
"description": "Success response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TechUsersResponse"
},
"example": {
"users": [
{
"id": "4433764",
"linkedin_username": "rodriguezstrategies",
"linkedin_company_id": "9412744",
"domain": "rodriguezstrategies.com",
"company_name": "Rodriguez Strategies",
"company_logo": "https://media.licdn.com/dms/image/v2/C560BAQGW4JcKeWR7gA/company-logo_200_200/company-logo_200_200/0/1630638468536/rodriguezstrategies_logo?e=2147483647&v=beta&t=1m_sqXB68840sPORZ_oXeyx1jVTYdM1YxPTqlVFeaTo",
"company_address": null,
"industry": "Government Relations",
"company_size_range": "2-10",
"company_size_range_estimated": "false",
"company_description": "Significant public policy is shaped at the local level and then spreads outward. At Rodriguez Strategies, our team navigates the political culture of any city, county, or region. We are a boutique public affairs firm where clients receive tailor-made blueprints designed to address their specific challenges. We pride ourselves on the ability to create unique and targeted plans designed for success. Our experienced leadership team is intimately involved in every engagement from start to finish and can quickly and effectively deploy resources to achieve the policy and advocacy goals of our clients.\n\nWe work with clients across the business, political, and nonprofit sectors to drive THEIR agenda. Absorbing complicated policy materials and seeking solutions is our specialty, and we immerse ourselves in the issue at hand. We use a unique combination of research, coalition building, and local outreach to mobilize stakeholders around our clients' goals.",
"country": "US",
"vendor_name": "Coupa",
"vendor_category": "account payable and receivable automation",
"vendor_url": "coupa.com",
"plan_name": null
}
],
"pagination": {
"page": 1,
"per_page": 2,
"total_pages": 26721,
"total_items": 53442,
"next_token": "2q4fasdfasdfdsa"
}
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"422": {
"description": "Validation errors",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ValidationErrorResponse"
}
}
}
}
}
}
}
},
"components": {
"securitySchemes": {
"ApiKeyAuth": {
"type": "apiKey",
"in": "query",
"name": "api_key",
"description": "API key for authentication"
}
},
"schemas": {
"TechUsersResponse": {
"type": "object",
"properties": {
"users": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TechUser"
},
"description": "Array of tech signal objects"
},
"pagination": {
"$ref": "#/components/schemas/Pagination"
}
},
"required": [
"users",
"pagination"
]
},
"TechUser": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Customer ID"
},
"linkedin_username": {
"type": "string",
"description": "LinkedIn username of the company"
},
"linkedin_company_id": {
"type": "string",
"description": "LinkedIn company id of the company"
},
"domain": {
"type": "string",
"description": "Company domain/website of the company"
},
"company_name": {
"type": "string",
"description": "Name of the company"
},
"company_logo": {
"type": "string",
"description": "URL to company logo"
},
"company_address": {
"type": "string",
"description": "Company address, if found"
},
"industry": {
"type": "string",
"description": "Company industry of the company"
},
"company_size_range": {
"type": "string",
"description": "Company size range"
},
"company_size_range_estimated": {
"type": "boolean",
"description": "true if the company_size_range was estimated by us, or false if it was taken directly from their Linkedin company profile"
},
"company_description": {
"type": "string",
"description": "Company description"
},
"country": {
"type": "string",
"description": "Company country"
},
"vendor_name": {
"type": "string",
"description": "Name of the technology vendor"
},
"vendor_category": {
"type": "string",
"description": "Category of the vendor/technology"
},
"vendor_url": {
"type": "string",
"description": "URL to vendor website"
},
"usage_started_at": {
"type": "string",
"description": "Date in which we detected this customer first started usage of this vendor in YYYY-MM-DD format"
},
"plan_name": {
"type": "string",
"nullable": true,
"description": "the name of the product plan this customer is currently in (most of the time it is null, but if we know it, it is indicated here)"
},
"context_url": {
"type": "string",
"nullable": true,
"description": "the url where we detected the customer (if a link or internal subdomain was the source)"
}
},
"required": [
"id",
"domain",
"company_name",
"industry",
"company_size_range",
"company_size_range_estimated",
"country",
"vendor_name",
"vendor_category",
"vendor_url"
]
},
"Pagination": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Current page number"
},
"per_page": {
"type": "integer",
"description": "Number of items per page"
},
"total_pages": {
"type": "integer",
"description": "Total number of pages"
},
"total_items": {
"type": "integer",
"description": "Total number of items"
}
},
"required": [
"page",
"per_page",
"total_pages",
"total_items"
]
},
"ErrorResponse": {
"type": "object",
"properties": {
"error": {
"type": "string",
"description": "Error message"
},
"code": {
"type": "integer",
"description": "Error code"
}
}
},
"ValidationErrorResponse": {
"type": "object",
"properties": {
"errors": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Validation error messages grouped by field"
},
"message": {
"type": "string",
"description": "General error message"
}
}
}
}
}
}
```