Retrieve customers based on address details.

GET

/v1/customers/by-address

Search and retrieve customers by address information. Supports pagination via query parameters offset (default 0) and limit (default 20).

Request

Query Params

Responses

🟢200

application/json

Customers retrieved successfully

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.fieldedge.com/open-api/v1/customers/by-address?addressLine1=undefined&addressLine2=undefined&city=undefined&stateOrRegion=undefined&postalCode=undefined&offset=undefined&limit=undefined'

Response Example

200 - response

{
    "total": 2,
    "limit": 20,
    "offset": 0,
    "customers": [
        {
            "customerId": "c82bd0d3-55e5-4e45-a3d0-4281aadb24f8",
            "firstName": "John",
            "lastName": "Doe"
        },
        {
            "customerId": "a7b2d1e3-5f89-4b1d-9a6e-2c9b8f2a0b44",
            "firstName": "Jane",
            "lastName": "Smith"
        }
    ]
}

Modified at 2026-04-21 12:31:59

Fetches lead details based on the provided lead identifier.

Retrieve customer details by ID