GetResponse

GetResponse Search Contacts API

Search Contacts API documentation API documentation

GitHub OpenAPI
Business capability
Customer Segmentation Management BC-420.20

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /search-contacts/{searchContactId} Get a saved segment definition · Get search contacts by contact ID #
Ask an LLM
“What conditions make up one of my saved contact segments?”
“Can I view the filter rules behind a saved search?”
Tell an agent
Show the conditions of saved segment {searchContactId}.
Get the filter definition of saved search {searchContactId}.
POST /search-contacts/{searchContactId} Update a saved segment · Update search contacts #
Ask an LLM
“Can I change the conditions of a segment I already saved?”
“Is it possible to rename a saved contact search?”
Tell an agent
Update saved segment {searchContactId} with sections {section} joined by {sectionLogicOperator}.
Rename saved segment {searchContactId} to {name}, keeping sections {section} and operator {sectionLogicOperator}.
DELETE /search-contacts/{searchContactId} Delete a saved segment · Delete search contacts #
Ask an LLM
“How do I remove a saved contact segment I no longer use?”
“Does deleting a saved search remove the filter itself rather than the contacts?”
Tell an agent destructive · confirm first
Delete saved segment {searchContactId}.
Remove the saved contact search {searchContactId}.
GET /search-contacts/{searchContactId}/contacts List contacts in a saved segment · Get contacts by search contacts ID #
Ask an LLM
“Which contacts currently match one of my saved segments?”
“Can I sort the members of a saved search by email or signup date?”
Tell an agent
List the contacts matching saved segment {searchContactId}.
Show page {page} of contacts in segment {searchContactId}.
POST /search-contacts/{searchContactId}/custom-fields Set custom fields for a whole segment · Upsert custom fields by search contacts #
Ask an LLM
“Can I update a custom field for every contact in a segment at once?”
“Will bulk-setting custom fields on a segment overwrite values that aren't in my request?”
Tell an agent
Set custom field values {customFieldValues} on everyone in segment {searchContactId}.
Bulk-update custom fields to {customFieldValues} for every contact matching saved search {searchContactId}.
GET /search-contacts List saved segments · Get a saved search contact list #
Ask an LLM
“Which saved contact segments (custom filters) do I have?”
“Can I find a saved search by name or creation date?”
Tell an agent
List all my saved segments.
Find saved segments named {name}.
POST /search-contacts Create a saved segment · Create search contacts #
Ask an LLM
“How do I save a new contact segment for later reuse?”
“Can I combine several condition sections into one saved search?”
Tell an agent
Save a segment named {name} with sections {section} joined by {sectionLogicOperator}.
Create a saved contact search of {subscribersType} contacts using sections {section} and operator {sectionLogicOperator}.
POST /search-contacts/contacts Find contacts matching ad-hoc conditions · Search contacts using conditions #
Ask an LLM
“Can I search contacts by conditions without saving a segment first?”
“Which contacts match a one-off filter I define on the fly?”
Tell an agent
Find contacts matching sections {section} joined by {sectionLogicOperator}, without saving it.
Run a one-off contact search with sections {section} and operator {sectionLogicOperator}, sorted by email {email}.

Documentation

📖
Documentation
https://apidocs.getresponse.com/v3
📖
APIReference
https://apireference.getresponse.com/
📖
Authentication
https://apidocs.getresponse.com/v3/authentication
📖
RateLimits
https://apidocs.getresponse.com/v3/limits

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/getresponse/refs/heads/main/openapi/getresponse-search-contacts-api-openapi.yml

Other Resources

🔗
Webhooks
https://apidocs.getresponse.com/v3/webhooks
🔗
ErrorCatalog
https://apidocs.getresponse.com/v3/errors
🔗
Postman
https://apidocs.getresponse.com/getresponse-postman-collection.zip

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/getresponse:getresponse-search-contacts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

getresponse-search-contacts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: GetResponse APIv3 Search Contacts API
  description: '# Limits and throttling


    GetResponse API calls are subject to throttling to ensure a high level of service for all users.'
  contact:
    name: API Support - DevZone
    url: https://app.getresponse.com/feedback.html?devzone=yes
    email: getresponse-devzone@cs.getresponse.com
  version: 3.2026-07-28T07:58:55+00:00
  x-logo:
    url: https://us-ws.gr-cdn.com/images/global/getresponse.png
servers:
- url: https://api.getresponse.com/v3
  description: GetResponse
- url: https://api3.getresponse360.com/v3
  description: GetResponse MAX US
- url: https://api3.getresponse360.pl/v3
  description: GetResponse MAX PL
tags:


# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/getresponse/refs/heads/main/openapi/getresponse-search-contacts-api-openapi.yml