Email Feed API Documentation

Complete reference for integrating with the Noesis Email Feed API

Quick Start

Get started quickly with a simple cURL request:

curl -X POST https://email.noesistechnology.com/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john.doe@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "5551234567"
  }'

The Email Feed API allows you to submit email addresses for validation and processing through our email feed system.

Authentication

Authenticate your requests using one of these methods:

Option 1: Header (Recommended)

x-api-key: YOUR_API_KEY

Option 2: Query Parameter

?apiKey=YOUR_API_KEY

Option 3: Request Body

{
  "apiKey": "YOUR_API_KEY",
  "email": "john.doe@example.com"
}

Endpoint & Request

Headers

POST Request

curl -X POST https://email.noesistechnology.com/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john.doe@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "5551234567",
    "zip": "90210",
    "state": "CA",
    "dob": "1990-01-15",
    "subid": "campaign123"
  }'

GET Request

You can also submit data via query parameters:

curl "https://email.noesistechnology.com/?apiKey=YOUR_API_KEY&email=john.doe@example.com&first_name=John&last_name=Doe"

Request Body

Responses

Success Response

When an email is successfully processed:

{
  "status": "processed"
}

Rejection Response

When an email is rejected during validation:

{
  "status": "rejected",
  "reason": "invalid email"
}

Rejection Reasons

Duplicate Submissions

Each email address is accepted once per calendar day (US Eastern time). If the same address is submitted again that day, from any source, the request is not processed again and returns status rejected with reason duplicate:

{
  "status": "rejected",
  "reason": "duplicate"
}

• Only submissions that returned processed count. An address that was rejected for any other reason can be submitted again.
• The window is the calendar day, not a rolling 24 hours. It resets at midnight US Eastern.
• A duplicate rejection is final for that day. Do not retry it.

Error Responses

Bad Request

{
  "error": "Bad Request",
  "message": "Invalid request."
}

Authentication Error

{
  "error": "Unauthorized"
}

Method Not Allowed

{
  "error": "Method Not Allowed"
}

Internal Server Error

{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred."
}

Error Handling & Retry

Retry Guidelines

Status Codes

Rate Limits

Support

For assistance with the API:

• Include the full request details in all support inquiries
• Contact your account representative
• Telegram: @davidacimovic

Changelog