API

RevenueGrids API Documentation

Plug into a real-time contact database of 700M+ contacts with 100% verified email and phone data

🔐 API Rate Limits

RevenueGrids API enforces a rate limit on POST requests: 50 per minute and 2000 per day.

🔐 Authentication

This API uses Basic Authentication. Each request must include the `Authorization` header with your token.

Authorization: Basic <TOKEN>'

🌐 Base URL

RevenueGrids API enforces a rate limit on POST requests: 50 per minute and 2000 per day.

https://api.pipelineai.com

📄 Endpoints

GET/api/v1/bulk_enrichment

Retrieve a list of bulk enrichments.

Request

// supports pagination query params: limit, pageNum, sortBy, sortOrder

curl https://api.pipelineai.com/api/v1/bulk_enrichment -H 'Authorization: Basic <TOKEN>'

Response

{
    "code": 200,
    "data": {
        "lists": [
            {
                "_id": "687f32e66dfb1c3242b26212",
                "name": "Custom Contacts",
                "entityType": "contactList",
                "status": "public",
                "isDynamic": false,
                "completionStatus": "complete",
                "companies": 0,
                "contacts": 4,
                "createdBy": "6613b22c91999bd165ef1111",
                "isArchived": false,
                "customColumns": [],
                "exaList": [],
                "createdAt": "2025-07-22T06:38:30.759Z",
                "updatedAt": "2025-07-22T06:39:34.415Z"
            },
        ]
        "createdByData": {
            "6613b22c91999bd165ef1111": [
                {
                    "_id": "6613b22c91999bd165ef1111",
                    "userName": "Test User"
                }
            ],
        },
        "totalRecords": 1,
        "totalPages": 1,
        "pageNum": 1
}

GET/api/v1/bulk_enrichment/:bulkListId

Retrieve one bulk enrichment by id.

Request

// supports pagination query params: limit, pageNum, sortBy, sortOrder

curl https://api.pipelineai.com/api/v1/bulk_enrichment/:bulkListId -H 'Authorization: Basic <TOKEN>'

Response

{
    "code": 200,
    "data": {
        "listTitle": "Bulk list 1",
        "listData": [
            {
                "_id": "6885db06b06cbb2ab8dba87e",
                "firstName": "test",
                "lastName": "test",
                "linkedIn": "linkedin.com/in/test",
                "jobTitle": "co-founder",
                "company": {
                    "_id": "67c6172067726915f3445ff3",
                    "name": "test",
                    "domain": "test.com",
                    "industry": "computer software",
                    "address": {
                        "city": "san jose",
                        "state": "california",
                        "country": "united states"
                    }
                },
                "address": {
                    "city": "sydney",
                    "state": "new south wales",
                    "country": "australia"
                },
                "level": "owner",
                "industry": "computer software",
                "department": "operations",
                "subDepartment": "executive",
                "createdAt": "2025-08-08T11:09:58.971Z",
                "updatedAt": "2025-08-08T11:15:19.150Z",
                "isCustom": false,
                "emails": [
                    {
                        "email": "test@test.com",
                        "status": "catch-all",
                    },
                ],
                "phones": [
                    {
                        "phoneNumber": "+18587777777",
                        "status": "valid",
                    }
                ],
                "primaryEmail": "test@test.com",
                "primaryPhone": "+18587777777",
                "lastPhoneEnrichment": "2025-08-08T11:15:17.813Z",
                "lastEmailEnrichment": "2025-08-08T11:15:17.813Z",
                "campaignStatus": "Never contacted"
            }
        ],
        "totalRecords": 1,
        "totalPages": 1,
        "pageNum": 1
    }
}

POST/api/v1/bulk_enrichment

Run bulk enrichment.

Body with LinkedIn URLs (max 100 inputs per request)

{
    "bulkListTitle": "Example by LinkedIn",
    // supported values for enrichType: all, email, phone
    "enrichType": "all" ,
    "inputs": [
      { "url": "https://linkedin.com/in/imogen-low" },
      { "url": "https://www.linkedin.com/in/maikal-yamauchi/" }
    ]
}

Request:

curl 'https://api.pipelineai.com/api/v1/bulk_enrichment' --data-raw '{"bulkListTitle":"New list","inputs":[{"url":"https://linkedin.com/in/imogen-low"},{"url":"https://www.linkedin.com/in/maikal-yamauchi/"}],"enrichType":"all"}' -H 'Authorization: Basic <TOKEN>'

Response:

{
    message: "Bulk enrichment triggered successfully, estimated waiting time: 3 minutes",
    data: { listIds: ["6854103f722564a69c4e3b16"], enrichType: "all" },
}

Body with a list of contacts (max 100 inputs per request)

{
    "bulkListTitle": "Example by person data",
    // supported values for enrichType: all, email, phone
    "enrichType": "all",
    "inputs": [
      { "name": "Imogen Low", "company": "KompassAI", "location": "San Francisco" },
      { "name": "Saurav Bubber", "company": "Stealth Startup", "location": "San Francisco" }
    ]
}

Request:

curl 'https://api.pipelineai.com/api/v1/bulk_enrichment' --data-raw '{"bulkListTitle":"New list","inputs":[{"name":"Imogen Low","company":"KompassAI","location":"San Francisco"},{"name":"Saurav Bubber","company":"Stealth Startup","location":"San Francisco"}],"enrichType":"all"}' -H 'Authorization: Basic <TOKEN>'

Response:

{
    message: "Bulk enrichment triggered successfully, estimated waiting time: 3 minutes",
    data: { listIds: ["6854103f722564a69c4e3b16"], enrichType: "all" },
}

GET/api/v1/email_validation

Returns all email validation results.

Request

curl https://api.pipelineai.com/api/v1/email_validation/:emailsListId -H 'Authorization: Basic <TOKEN>'

Response:

{
  "message": "Data fetched successfully",
  "data":     {
      "id": UUID,
      "completed": true,
      "progress": 100,
      "userId": UUID,
      "emailsListTitle": "Verify1",
      "createdAt": "2025-05-27T04:22:30.707Z",
      "completedAt": "2025-05-27T04:22:47.995Z",
      "creditsConsumed": 15,
      "emails": [
        {
          "email": "disposable@example.com",
          "status": "do_not_mail"
        },
        {
          "email": "invalid@example.com",
          "status": "invalid"
        },
        {
          "email": "valid@example.com",
          "status": "valid"
        }
      ]
    }
}

GET/api/v1/email_validation/:emailsListId

Retrieve one emails list validation by id.

Request

curl https://api.pipelineai.com/api/v1/email_validation/:emailsListId -H 'Authorization: Basic <TOKEN>'

Response:

{
  "message": "Data fetched successfully",
  "data":     {
      "id": UUID,
      "completed": true,
      "progress": 100,
      "userId": UUID,
      "emailsListTitle": "Verify1",
      "createdAt": "2025-05-27T04:22:30.707Z",
      "completedAt": "2025-05-27T04:22:47.995Z",
      "creditsConsumed": 15,
      "emails": [
        {
          "email": "disposable@example.com",
          "status": "do_not_mail"
        },
        {
          "email": "invalid@example.com",
          "status": "invalid"
        },
        {
          "email": "valid@example.com",
          "status": "valid"
        }
      ]
    }
}

POST/api/v1/email_validation

Trigger validation list of emails.

Request

Body:
{
  "emails"*: [
    { "email": "valid@example.com" }
  ],
  "emailsListTitle"*: "Validate emails"
}

curl https://api.pipelineai.com/api/v1/email_validation -X 'POST' --data-raw '{"emails":[{"email":"valid@example.com"}],"emailsListTitle":"Validate emails"}' -H 'Authorization: Basic <Token>'

Response:

{
  "message": "Email validation started.",
  "data": {
    "emailsListId": UUID
  }
}

Because average doesn't close.

Built to make you extraordinarily productive. Pipeline is the best way to sell with AI.