Cognism

Cognism Redeem API

Exchange a redeem ID for the full record.

GitHub OpenAPI

Operations 2

POST /api/search/contact/redeem Redeem contacts by redeem ID #
POST /api/search/account/redeem Redeem accounts by ID #

Documentation

📖
APIReference
https://developers.cognism.com/
📖
Documentation
https://help.cognism.com/hc/en-gb/articles/37382868352914-Cognism-API-Overview
📖
GettingStarted
https://help.cognism.com/hc/en-gb/articles/34195245226258-How-to-Generate-an-API-Token
📖
Authentication
https://help.cognism.com/hc/en-gb/articles/37383428888978-API-Authentication-Credits

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cognism/refs/heads/main/openapi/cognism-redeem-api-openapi.yml

Other Resources

🔗
Postman
https://developers.cognism.com/
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/cognism/refs/heads/main/errors/cognism-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/cognism/refs/heads/main/data-model/cognism-data-model.yml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/cognism/refs/heads/main/examples/_index.yml
🔗
ContactSales
https://www.cognism.com/contact

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/cognism-redeem-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

cognism-redeem-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Cognism Redeem API
  version: '2026-08-13'
  summary: Search, enrich and redeem B2B contact and company data from the Cognism database.
  description: 'The Cognism API is used to search, preview and enrich Contacts and Accounts.


    It is composed of three services that are used together:


    - **Search API** - find contacts or companies matching a filter set. Returns preview records, each carrying a `redeemId`.

    - **Enrich API** - find the best matching Cognism record for a contact or company you already hold. Returns a preview, a `matchScore` and a `redeemId`.

    - **Redeem API** - exchange a `redeemId` for the full record.


    Search and Enrich return preview data only and do not consume Credits. Credits are consumed when a contact is redeemed for the first time; account redemptions and repeat contact redemptions are free.


    The fields a Redeem response carries are governed by your organisation API Entitlements, configured by Cognism. Query the Entitlement API to read them.


    API access is sales-gated: it must be enabled on your subscription, entitlements configured by the Cognism Provisioning team, and an API token generated in the Cognism app under Settings > Tokens and API.


    _Derived by API Evangelist from the Cognism API Postman collection published by Cognism at https://developers.cognism.com/ . Not an official Cognism artifact._'
  contact:
    name: Cognism
    url: https://www.cognism.com/contact
  termsOfService: https://www.cognism.com/terms-of-website-use
  x-source: https://documenter.gw.postman.com/api/collections/14862827/UVJhBu4C
  x-derived-by: API Evangelist enrichment pipeline
  x-derived-on: '2026-08-13'
servers:
- url: https://app.cognism.com
  description: Production. Value of the `baseUrl` variable in the Production environment published with the Cognism API Postman collection.
security:
- bearerAuth: []
tags:
- name: Redeem
  description: Exchange a redeem ID for the full record.
paths:
  /api/search/contact/redeem:
    post:
      operationId: redeemContacts
      summary: Redeem contacts by redeem ID
      description: Retrieve full contact records for up to 20 redeem IDs returned by the Search or Enrich API. Redeeming a contact for the first time CONSUMES CREDITS; re-redeeming the same contact does not. Only fields inside your API Entitlement are returned.
      tags:
      - Redeem
      parameters:
      - name: mergePhonesAndLocations
        in: query
        required: false
        description: Merge phone numbers and locations into consolidated arrays.
        schema:
          type: boolean
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RedeemRequest'
            examples:
              singleRedeemId:
                summary: Redeem Contacts by IDs (collection example)
                value:
                  redeemIds:
                  - YmVkOWMxZDItYjgwNi0zN2I2LTk2MzItNzVlZjk5MWE0ODdhOzFjNmY4MDg2LTAzNjktMzIyMi1hMjU3LWI1ZmQxZDVlNTc3NTsyZjdjZDBmMC01NWM2LTNlMWEtYjliNi0xZTU1MDQ3ZmFmY2Y=
      responses:
        '200':
          description: Full contact records.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactRedeemResponse'
              examples:
                RedeemContactAdvancedEntitlement:
                  summary: Redeem Contact Advanced Entitlement
                  value:
                    totalResults: 1
                    results:
                    - account:
                        name: Cognism
                        id: efc6d975-8599-38ab-8cfe-e1c42ac16dc6
                        officePhoneNumbers:
                        - number: '+16469719264'
                          numberType: FIXED_LINE_OR_MOBILE
                          label: COMPANY_SWITCHBOARD
                          score: 20
                          dnc: false
                          addressType: office
                        - number: '+442038580822'
                          numberType: FIXED_LINE
                          label: COMPANY_SWITCHBOARD
                          score: 20
                          dnc: false
                          addressType: office
                        hiringEvent:
                        - country: Germany
                          jobTitle: Campaign Managers
                          employer: Cognism
                          url: https://apply.workable.com/cognism-ltd/j/588BCA3EEE/
                          type: CompanyHiring
                          jobDate: '2023-09-05'
                        headcount: 500
                        sizeTo: 1000
                        sizeFrom: 501
                        location:
                        - addressType: office
                          country: Croatia
                          state: Zadarska
                          city: Zadar
                          street: 16 Put Murvice
                        - addressType: office
                          country: Germany
                          state: North Rhine-westphalia
                          city: Köln
                          street: 4 Friesenplatz Friesenpl.
                        - addressType: office
                          country: United States
                          state: New York
                          city: New York City
                          street: 43 W 23rd St
                        - addressType: office
                          country: Republic of North Macedonia
                          state: Karpoš
                          city: Skopje
                          street: Orce Nikolov Br.146 B
                        - addressType: hq
                          country: United Kingdom
                          state: England
                          city: London
                          street: 92 Albert Embankment
                        - addressType: office
                          country: United States
                          state: Massachusetts
                        - addressType: office
                          country: United Kingdom
                          state: England
                          city: London
                          zip: se1 6dp
                        technologies:
                        - git
                        - Vue.js
                        - Atlassian Jira
                        - Bing Ads
                        - C++
                        - Webpack
                        - C#
                        - Linkedin
                        - Piwik
                        - Modernizr
                        - Twitter Ads
                        - JavaScript
                        - PHP
                        - Unpkg
                        - Typekit
                        - Bootstrap
                        - Microsoft Azure
                        - Babel
                        - G Suite
                        - Python
                        - Cowboy
                        - Preact
                        - Meddicc
                        - cdnjs
                        - Trustpilot
                        - Sieben
                        - WordPress
                        - Google
                        - Docker
                        - Mailtastic
                        - Salesloft
                        - TypeScript
                        - CookieFirst
                        - RSS
                        - Hotjar
                        - Netsuite
                        - Optimise
                        - JSS
                        - Google Font API
                        - Linux
                        - Capterra
                        - AppNexus
                        - Moment.js
                        - AngularJS
                        - Cognism
                        - Facebook
                        - Facebook Pixel
                        - jsDelivr
                        - Open Graph
                        - Erlang
                        - Twitter Emoji (Twemoji)
                        - Intercom
                        - Linkedin Sign-in
                        - Reddit Ads
                        - Pardot
                        - Microsoft Advertising
                        - .NET
                        - React
                        - Envoy
                        - Twitter
                        - Exhibit
                        - Microsoft Excel
                        - Java
                        - Apache Spark
                        - CloudFlare
                        - Salesforce
                        - Captivate.fm
                        - Google Ads
                        - TrackJs
                        - Ahrefs
                        - Yoast SEO
                        - MediaElement.js
                        - Font Awesome
                        - Google Tag Manager
                        - RequireJS
                        - YUI
                        - Zendesk
                        - Salesforce Marketing Cloud Account Engagement
                        - Apache
                        - Kubernetes
                        - Hubspot
                        - Google Analytics
                        - jQuery
                        - Google Optimize
                        - Cloudflare Bot Management
                        - Node.js
                        - Microsoft
                        - PostgreSQL
                        - jQuery Modal
                        - Google Maps
                        - Gravatar
                        - jQuery CDN
                        - HSTS
                        - Slick
                        - Squarespace
                        - Google Docs
                        - HubSpot Analytics
                        - Scala
                        - LinkedIn Ads
                        - Angular
                        - Zoom
                        - Github
                        - Linkedin Insight Tag
                        - MongoDB
                        - MySQL
                        - YouTube
                        - NoSQL
                        - HubSpot CMS Hub
                        - Qualified
                        - HTTP/3
                        - Bitbucket
                        - Lessonly
                        - Akita
                        - Slack
                        - Office 365 Mail
                        - Cadence
                        - BeeFree
                        - SaaS
                        - GDPR
                        - G2 Crowd
                        - Engage
                        - Deep Learning
                        - Tandem
                        - Eloqua
                        - Websphere
                        - Cloudflare DNS
                        - Backlog
                        - AccuRate
                        - Outbound
                        - Gensim
                        - Yield
                        - Informed
                        - SQL
                        - Via
                        - Achievers
                        - Datadog
                        - Excel
                        - ROOT
                        - Tensorflow
                        - Replicated
                        - Outreach
                        - Pivotal
                        - Summit
                        - Retargeting
                        - EmbARK
                        - Tableau
                        - Ai
                        - Acumen
                        - AND CO
                        - Later
                        - Sales Representative
                        - Adobe
                        - Digital Marketing
                        - AMP
                        - SEO
                        - ZipRecruiter
                        - LiNK
                        - Forefront
                        - ASSET
                        - LinkedIn Insights
                        - GoDaddy
                        - Redshift
                        - Gmail
                        - Microsoft Dynamics
                        - Figma
                        - Docusign
                        - Timely
                        - Integrate
                        - OnSite
                        - SPENT
                        - Ubuntu
                        - Effective
                        - Artificial Intelligence
                        - Boost
                        - Lifecycle
                        - Machine Learning
                        - Streamline
                        - Node
                        - Matplotlib
                        - HubSpot CRM
                        - IBM
                        - 401K
                        - Outlook
                        - Intel
                        - Clarity
                        - Drift
                        - REP
                        - Windows 10
                        - Turtl
                        - Ml
                        - Onboard
                        - Data Science
                        - Flourish
                        - Pytorch
                        - AWS
                        - Teams
                        - Insights
                        - Microsoft Exchange
                        - Ifrs
                        - ACT
                        - CPL
                        - Pertinent
                        - Community
                        - Java EE
                        - WorkFLOW
                        - Form
                        - Prospect
                        - Sandbox
                        - R
                        - Symantec
                        - Gauge
                        - Amazon
                        - Photoshop
                        type: Privately Held
                        domain: cognism.com
                        industry:
                        - Computer Software
                        revenue: 67000000
                        linkedinUrl: https://www.linkedin.com/company/cognism
                        website: cognism.com
                        founded: 2013
                        lastConfirmed: 1677741025000
                        naics:
                        - '51'
                        - '5182'
                        sic:
                        - '73'
                        - '737'
                        shortDescription: Cognism is a B2B sales acceleration software company that provides a marketing and sales acceleration solution.
                        description: "Cognism is a leader in international sales intelligence, setting a new standard for data quality and compliance, trusted by 1800+ revenue teams worldwide.\n\nCognism helps businesses find, engage and close their dream prospects by providing premium company and contact information, including firmographics, technographics, sales trigger events, intent data, verified business emails and phone-verified mobile numbers. \n\nNext level GDPR & CCPA compliance, combined with innovative technology and integrations with leading CRM and sales engagement partners, make Cognism the number one choice for businesses looking to create a predictable pipeline, find their next best business opportunity and overcome global compliance barriers."
                      jobTitle: Chief Innovation Officer
                      lastName: Buljat
                      firstName: Stjepan
                      fullName: Stjepan Buljat
                      id: 34d633b7-41ea-3ac7-a280-431d71fd77eb
                      privacyNotificationSent: true
                      previousAccounts:
                      - name: ETNA d.o.o.
                        end: March 2016
                        title: Product Development Manager
                        start: September 2013
                      - name: ETNA d.o.o.
                        end: September 2013
                        title: R&D Team Leader
                        start: December 2008
                      - name: SRCE
                        end: October 2005
                        title: Researcher
                        start: February 2005
                      - name: Cognism
                        end: September 2023
                        title: Group CTO And Co-Founder
                        start: March 2016
                      - name: ETNA d.o.o.
                        end: September 2013
                        title: IT Architect
                        start: January 2006
                      skills:
                      - Servlets
                      - Akka
                      - Apache
                      - Message Queue
                      - Websphere
                      - WebSphere MQ
                      - UML
                      - Cloud Computing
                      - JPA
                      - Java
                      - Glassfish
                      - Eclipse
                      - Mac OS X
                      - Blackberry
                      - VisualAge
                      - MySQL
                      - Db4o
                      - EJB
                      - iPhone
                      - MQ
                      - Framework Design
                      - Tomcat
                      - "WebSphere Application Server\n          \n\n        \n          WebSphere Application Server"
                      - REST
                      - Groovy
                      - Smalltalk
                      - Django
                      - Ant
                      - JMS
                      - Play! Framework
                      - Scala
                      - JBoss Application Server
                      - PostgreSQL
                      - JDBC
                      - Swing
                      - JMX
                      - Maven
                      - spray-io
                      - pureQuery
                      - DB2
                      - Amazon Web Services
                      - Git
                      - Java Enterprise Edition
                      - SQL
                      - Problem Solving
                      - JSF
                      - J2EE
                      - Transaction Processing
                      - JUnit
                      - Jasper Reports
                      linkedinUrl: https://www.linkedin.com/in/stjepanbuljat
                      email:
                        address: stjepan.buljat@cognism.com
                        quality: HIGH_PLUS
                        sha256: 8196f25443a02b758c7fbd4b5c0ce86c71eadda92f49709eb5e2e3515d586929
                      education:
                      - start: '2013'
                        end: '2013'
                        school: Certified ScrumMaster Training
                        degree: Certified ScrumMaster, Project Management
                      - start: '2005'
                        end: '2005'
                        school: Cisco Certified Network Associate program
                        degree: Computer Systems Networking and Telecommunications
                      - start: '2000'
                        end: '2005'
                        school: FER
                        degree: Master of Science in Computing (mag.ing.comp), Computing
                      - start: '2007'
                        end: '2012'
                        school: Faculty of Economics & Business Zagreb
                        degree: MBA, Economics
                      country: Croatia
                      jobLeaveEvent:
                      - date: 31.08.2023
                        from:
                          name: Cognism
                          title: Group CTO And Co-Founder
                        to:
                          name: cognism
                          title: Chief Innovation Officer
                      jobJoinEvent:
                      - date: 01.09.2023
                        from:
                          name: university of zadar
                          title: Computer Science Teaching Assistant
                        to:
                          name: cognism
                          title: Chief Innovation Officer
                      mobilePhoneNumbers:
                      - number: '+123456789'
                        numberType: MOBILE
                        label: DIRECT_DIAL
                        score: 99
                        dnc: false
                      positionStartDate: September 2023
                      jobFunction:
                      - BUSINESS
                      - OVERSIGHT
                      managementLevel: Executive-Level
                      lastConfirmed: 1714687499208
                      redeemId: MzRkNjMzYjctNDFlYS0zYWM3LWEyODAtNDMxZDcxZmQ3N2ViO2IxMjBjOTdhLTlhNTItM2E3Zi1iNzNiLTg3MGUzYjQ0M2MxOTtlZmM2ZDk3NS04NTk5LTM4YWItOGNmZS1lMWM0MmFjMTZkYzY=
                RedeemContactStandardEntitlement:
                  summary: Redeem Contact Standard Entitlement
                  value:
                    totalResults: 1
                    results:
                    - account:
                        name: Cognism
                        id: efc6d975-8599-38ab-8cfe-e1c42ac16dc6
                        officePhoneNumbers:
                        - number: '+16469719264'
                          numberType: FIXED_LINE_OR_MOBILE
                          label: COMPANY_SWITCHBOARD
                          score: 20
                          dnc: false
                          addressType: office
                        - number: '+442038580822'
                          numberType: FIXED_LINE
                          label: COMPANY_SWITCHBOARD
                          score: 20
                          dnc: false
                          addressType: office
                        headcount: 500
                        sizeTo: 1000
                        sizeFrom: 501
                        location:
                        - addressType: office
                          country: Croatia
                          state: Zadarska
                          city: Zadar
                          street: 16 Put Murvice
                        - addressType: office
                          country: Germany
                          state: North Rhine-westphalia
                          city: Köln
                          street: 4 Friesenplatz Friesenpl.
                        - addressType: office
                          country: United States
                          state: New York
                          city: New York City
                          street: 43 W 23rd St
                        - addressType: office
                          country: Republic of North Macedonia
                          state: Karpoš
                          city: Skopje
                          street: Orce Nikolov Br.146 B
                        - addressType: hq
                          country: United Kingdom
                          state: England
                          city: London
                          street: 92 Albert Embankment
                        - addressType: office
                          country: United States
                          state: Massachusetts
                        - addressType: office
                          country: United Kingdom
                          state: England
                          city: London
                          zip: se1 6dp
                        technologies:
                        - git
                        - Vue.js
                        - Atlassian Jira
                        - Bing Ads
                        - C++
                        - Webpack
                        - C#
                        - Linkedin
                        - Piwik
                        - Modernizr
                        - Twitter Ads
                        - JavaScript
                        - PHP
                        - Unpkg
                        - Typekit
                        - Bootstrap
                        - Microsoft Azure
                        - Babel
                        - G Suite
                        - Python
                        - Cowboy
                        - Preact
                        - Meddicc
                        - cdnjs
                        - Trustpilot
                        - Sieben
                        - WordPress
                        - Google
                        - Docker
                        - Mailtastic
                        - Salesloft
                        - TypeScript
                        - CookieFirst
                        - RSS
                        - Hotjar
                        - Netsuite
                        - Optimise
                        - JSS
                        - Google Font API
                        - Linux
                        - Capterra
                        - AppNexus
                        - Moment.js
                        - AngularJS
                        - Cognism
                        - Facebook
                        - Facebook Pixel
                        - jsDelivr
                        - Open Graph
                        - Erlang
                        - Twitter Emoji (Twemoji)
                        - Intercom
                        - Linkedin Sign-in
                        - Reddit Ads
                        - Pardot
                        - Microsoft Advertising
                        - .NET
                        - React
                        - Envoy
                        - Twitter
                        - Exhibit
                        - Microsoft Excel
                        - Java
                        - Apache Spark
                        - CloudFlare
                        - Salesforce
                        - Captivate.fm
                        - Google Ads
                        - TrackJs
                        - Ahrefs
                        - Yoast SEO
                        - MediaElement.js
                        - Font Awesome
                        - Google Tag Manager
                        - RequireJS
                        - YUI
                        - Zendesk
                        - Salesforce Marketing Cloud Account Engagement
                        - Apache
                        - Kubernetes
                        - Hubspot
                        - Google Analytics
                        - jQuery
                        - Google Optimize
                        - Cloudflare Bot Management
                        - Node.js
                        - Microsoft
                        - PostgreSQL
                        - jQuery Modal
                        - Google Maps
                        - Gravatar
                        - jQuery CDN
                        - HSTS
                        - Slick
                        - Squarespace
                        - Google Docs
                        - HubSpot Analytics
                        - Scala
                        - LinkedIn Ads
                        - Angular
                        - Zoom
                        - Github
                        - Linkedin Insight Tag
                        - MongoDB
                        - MySQL
                        - YouTube
                        - NoSQL
                        - HubSpot CMS Hub
                        - Qualified
                        - HTTP/3
                        - Bitbucket
                        - Lessonly
                        - Akita
                        - Slack
                        - Office 365 Mail
                        - Cadence
                        - BeeFree
                        - SaaS
                        - GDPR
                        - G2 Crowd
                        - Engage
                        - Deep Learning
                        - Tandem
                        - Eloqua
                        - Websphere
                        - Cloudflare DNS
                        - Backlog
                        - AccuRate
                        - Outbound
                        - Gensim
                        - Yield
                        - Informed
                        - SQL
                        - Via
                        - Achievers
                        - Datadog
                        - Excel
                        - ROOT
                        - Tensorflow
                        - Replicated
                        - Outreach
                        - Pivotal
                        - Summit
                        - Retargeting
                        - EmbARK
                        - Tableau
                        - Ai
                        - Acumen
                        - AND CO
                        - Later
                        - Sales Representative
                        - Adobe
                        - Digital Marketing
                        - AMP
                        - SEO
                        - ZipRecruiter
                        - LiNK
                        - Forefront
                        - ASSET
                        - LinkedIn Insights
                        - GoDaddy
                        - Redshift
                        - Gmail
                        - Microsoft Dynamics
                        - Figma
                        - Docusign
                        - Timely
                        - Integrate
                        - OnSite
                        - SPENT
                        - Ubuntu
                        - Effective
                        - Artificial Intelligence
                        - Boost
                        - Lifecycle
                        - Machine Learning
                        - Streamline
                        - Node
                        - Matplotlib
                        - HubSpot CRM
                        - IBM
                        - 401K
                        - Outlook
                        - Intel
                        - Clarity
                        - Drift
                        - REP
                        - Windows 10
                        - Turtl
                        - Ml
                        - Onboard
                        - Data Science
                        - Flourish
                        - Pytorch
                        - AWS
                        - Teams
                        - Insights
                        - Microsoft Exchange
                        - Ifrs
                        - ACT
                        - CPL
                        - Pertinent
                        - Community
                        - Java EE
                        - WorkFLOW
                        - Form
                        - Prospect
                        - Sandbox
                        - R
                        - Symantec
                        - Gauge
                        - Amazon
                        - Photoshop
                        type: Privately Held
                        domain: cognism.com
                        industry:
                        - Computer Software
                        revenue: 67000000
                        linkedinUrl: https://www.linkedin.com/company/cognism
                        website: cognism.com
                        founded: 2013
                        lastConfirmed: 1677741025000
                        naics:
                        - '51'
                        - '5182'
                        sic:
                        - '73'
                        - '737'
                        shortDescription: Cognism is a B2B sales acceleration software company that provides a marketing and sales acceleration solution.
                        description: "Cognism is a leader in international sales intelligence, setting a new standard for data quality and compliance, trusted by 1800+ revenue teams worldwide.\n\nCognism helps businesses find, engage and close their dream prospects by providing premium company and contact information, including firmographics, technographics, sales trigger events, intent data, verified business emails and phone-verified mobile numbers. \n\nNext level GDPR & CCPA compliance, combined with innovative technology and integrations with leading CRM and sales engagement partners, make Cognism the number one choice for businesses looking to create a predictable pipeline, find their next best business opportunity and overcome global compliance barriers."
                      jobTitle: Chief Innovation Officer
                

# --- truncated at 32 KB (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cognism/refs/heads/main/openapi/cognism-redeem-api-openapi.yml