Cognism Enrichment API

# Cognism API - OpenAPI 3.1
# Derived by the API Evangelist enrichment pipeline from the Cognism API Postman
# collection Cognism publishes at https://developers.cognism.com/
# Source collection: https://documenter.gw.postman.com/api/collections/14862827/UVJhBu4C
# Derived: 2026-08-13  method: derived  (verbatim collection kept at postman/cognism-api-collection.json)
openapi: 3.1.0
info:
  title: Cognism 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: Search
  description: Find contacts and companies matching a filter set.
- name: Enrich
  description: Match a record you already hold to a Cognism record.
- name: Redeem
  description: Exchange a redeem ID for the full record.
- name: Entitlement
  description: Read which fields your organisation is licensed for.
- name: Filter
  description: Reference lists of values the search filters accept.
- name: Compliance
  description: Opt-out list lookups for GDPR/CCPA suppression.
paths:
  /api/search/contact/search:
    post:
      operationId: searchContacts
      summary: Search contacts
      description: Search the Cognism database for contacts matching your filters. Returns preview records
        with a `redeemId` for each match. Search does not consume Credits. Supports 20-100 records per
        request and up to 1,000 records per minute.
      tags:
      - Search
      parameters:
      - name: indexSize
        in: query
        required: false
        description: Records per page (20-100).
        schema:
          type: integer
          minimum: 20
          maximum: 100
          default: 25
      - name: lastReturnedKey
        in: query
        required: false
        description: Forward-only paging cursor returned by the previous response.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContactSearchRequest'
            examples:
              byNameAndCompany:
                summary: Search Contacts (collection example)
                value:
                  firstName: Stjepan
                  lastName: Buljat
                  jobTitles:
                  - Chief Innovation Officer
                  excludeJobTitles:
                  - CEO
                  regions:
                  - EMEA
                  mobilePhoneNumbers:
                    highPlus: true
                  emailQuality:
                    highPlus: true
                  account:
                    names:
                    - Cognism
                    officePhoneNumbers:
                      medium: true
      responses:
        '200':
          description: Matching contact previews.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactSearchResponse'
              examples:
                SearchContactsAdvancedEntitlement:
                  summary: Search Contacts Advanced Entitlement
                  value:
                    lastReturnedKey: 1714687499208_~34d633b7-41ea-3ac7-a280-431d71fd77eb
                    totalResults: 1
                    results:
                    - id: 34d633b7-41ea-3ac7-a280-431d71fd77eb
                      firstName: Stjepan
                      jobTitle: Chief Innovation Officer
                      account:
                        name: Cognism
                        id: efc6d975-8599-38ab-8cfe-e1c42ac16dc6
                        hasOfficePhoneNumbers: true
                        hasHqPhoneNumbers: false
                        hasHiringEvent: true
                        hasHeadcount: true
                        hasSize: true
                        hasLocation: true
                        hasTechnologies: true
                        hasType: true
                        hasDomain: true
                        hasIndustry: true
                        hasRevenue: true
                        hasLinkedinUrl: true
                        hasWebsite: true
                        hasFounded: true
                        hasLastConfirmed: true
                        hasNaics: true
                        hasIsic: false
                        hasSic: true
                        hasShortDescription: true
                        hasDescription: true
                      lastName: Buljat
                      fullName: Stjepan Buljat
                      hasPreviousAccounts: true
                      hasSkills: true
                      hasLocationMoveEvent: false
                      hasLinkedinUrl: true
                      hasEmail: true
                      hasEducation: true
                      hasZip: false
                      hasState: false
                      hasCountry: true
                      hasCity: false
                      hasRegion: false
                      hasJobLeaveEvent: true
                      hasJobJoinEvent: true
                      hasStreet: false
                      hasDirectPhoneNumbers: false
                      hasMobilePhoneNumbers: false
                      hasPositionStartDate: true
                      hasSeniority: false
                      hasJobFunction: true
                      hasManagementLevel: true
                      hasLastConfirmed: true
                      redeemId: MzRkNjMzYjctNDFlYS0zYWM3LWEyODAtNDMxZDcxZmQ3N2ViO2IxMjBjOTdhLTlhNTItM2E3Zi1iNzNiLTg3MGUzYjQ0M2MxOTtlZmM2ZDk3NS04NTk5LTM4YWItOGNmZS1lMWM0MmFjMTZkYzY=
                SearchContactsStandardEntitlement:
                  summary: Search Contacts Standard Entitlement
                  value:
                    lastReturnedKey: 1714687499208_~34d633b7-41ea-3ac7-a280-431d71fd77eb
                    totalResults: 1
                    results:
                    - id: 34d633b7-41ea-3ac7-a280-431d71fd77eb
                      firstName: Stjepan
                      jobTitle: Chief Innovation Officer
                      account:
                        name: Cognism
                        id: efc6d975-8599-38ab-8cfe-e1c42ac16dc6
                        hasHeadcount: true
                        hasSize: true
                        hasTechnologies: true
                        hasType: true
                        hasDomain: true
                        hasRevenue: true
                        hasWebsite: true
                        hasFounded: true
                        hasNaics: true
                        hasIsic: false
                        hasSic: true
                        hasShortDescription: true
                        hasDescription: true
                      lastName: Buljat
                      fullName: Stjepan Buljat
                      hasSkills: true
                      hasLinkedinUrl: true
                      hasEmail: true
                      hasEducation: true
                      hasZip: false
                      hasState: false
                      hasCountry: true
                      hasCity: false
                      hasStreet: false
                      hasPositionStartDate: true
                      hasSeniority: false
                      hasJobFunction: true
                      hasManagementLevel: true
                      hasLastConfirmed: true
                      redeemId: MzRkNjMzYjctNDFlYS0zYWM3LWEyODAtNDMxZDcxZmQ3N2ViO2IxMjBjOTdhLTlhNTItM2E3Zi1iNzNiLTg3MGUzYjQ0M2MxOTtlZmM2ZDk3NS04NTk5LTM4YWItOGNmZS1lMWM0MmFjMTZkYzY=
        '400': &id001
          description: Bad Request. The request body is invalid, a required field is missing, a parameter
            name is wrong, or a data type does not match the specification.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401': &id002
          description: Unauthorized. The API token is missing, invalid, expired, or the Authorization
            header is malformed. Entitlements may also be unset.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                missingCredentials:
                  value:
                  - key: MissingCredentials
                    code: 401
                    msg: Missing required credentials
        '404': &id003
          description: Not Found. The route does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                routeNotFound:
                  value:
                  - key: RouteNotFound
                    code: 404
                    msg: Not found
        '429': &id004
          description: Rate limit exceeded. Reduce request frequency and retry with backoff. Redeem throughput
            is capped at 1,000 records per minute.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /api/search/account/search:
    post:
      operationId: searchAccounts
      summary: Search accounts
      description: Search the Cognism database for companies matching your filters. Returns preview records.
        Search does not consume Credits.
      tags:
      - Search
      parameters:
      - name: indexSize
        in: query
        required: false
        description: Records per page (20-100).
        schema:
          type: integer
          minimum: 20
          maximum: 100
          default: 100
      - name: lastReturnedKey
        in: query
        required: false
        description: Forward-only paging cursor returned by the previous response.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountSearchRequest'
            examples:
              byNameAndDomain:
                summary: Search Accounts (collection example)
                value:
                  names:
                  - Cognism
                  domains:
                  - cognism.com
                  accountSearchOptions:
                    match_exact_account_name: true
                    match_exact_domain: false
                    filter_domain: exists
                    events_operator: AND
      responses:
        '200':
          description: Matching account previews.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountSearchResponse'
              examples:
                SearchAccountAdvancedEntitlement:
                  summary: Search Account Advanced Entitlement
                  value:
                    lastReturnedKey: efc6d975-8599-38ab-8cfe-e1c42ac16dc6
                    totalResults: 1
                    results:
                    - id: efc6d975-8599-38ab-8cfe-e1c42ac16dc6
                      name: Cognism
                      hasDomain: true
                      hasIndustries: true
                      hasDescription: true
                      hasShortDescription: true
                      hasFounded: true
                      hasWebsite: true
                      hasLinkedinUrl: true
                      hasRevenue: true
                      hasDepartment: true
                      hasSic: true
                      hasIsic: false
                      hasNaics: true
                      hasSize: true
                      hasHeadcount: true
                      hasTechnologies: true
                      hasType: true
                      hasCountry: true
                      hasState: true
                      hasCity: true
                      hasZip: true
                      hasStreet: true
                      hasOfficePhoneNumbers: false
                      hasHqPhoneNumbers: true
                      hasHiringEvent: false
                SearchAccountStandardEntitlement:
                  summary: Search Account Standard Entitlement
                  value:
                    lastReturnedKey: efc6d975-8599-38ab-8cfe-e1c42ac16dc6
                    totalResults: 1
                    results:
                    - id: efc6d975-8599-38ab-8cfe-e1c42ac16dc6
                      name: Cognism
                      hasDomain: true
                      hasIndustries: true
                      hasDescription: true
                      hasShortDescription: true
                      hasFounded: true
                      hasWebsite: true
                      hasLinkedinUrl: true
                      hasRevenue: true
                      hasDepartment: true
                      hasSic: true
                      hasIsic: false
                      hasNaics: true
                      hasSize: true
                      hasHeadcount: true
                      hasTechnologies: true
                      hasType: true
                      hasCountry: true
                      hasState: true
                      hasCity: true
                      hasZip: true
                      hasStreet: true
        '400': *id001
        '401': *id002
        '404': *id003
        '429': *id004
  /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 

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