Change Updates

Do not miss any Ocean.io API changes, ever again

Subscribe to the Ocean.io API changelog to be up to date on recent changes.

RSS

Changelog

Last update:
Compare
11 structure changes including:
11 Modifications
Modified 11
GET /v2/credits/balance
  • Response
  • 403, 402 responses Added
GET /v2/data-fields
  • Response
  • 402 response Added
POST /v2/autocomplete/companies
  • Response
  • 403 response Added
POST /v2/enrich/company
  • Response
  • 403 response Added
POST /v2/enrich/person
  • Response
  • 403 response Added
POST /v2/reveal/emails
  • Response
  • 403 response Added
POST /v2/reveal/phones
  • Response
  • 403 response Added
POST /v2/search/companies
  • Response
  • 403 response Added
POST /v2/search/people
  • Response
  • 403 response Added
POST /v2/warmup/companies
  • Response
  • 403, 402 responses Added
POST /v3/search/people
  • Body
  • application/json content type Modified
    • PeopleFiltersV2 property Modified
      • JobTitleKeywordsFilter property Added
  • Response
  • 403 response Added
1 structure change including:
1 Breaking change
1 Removal
Removed 1 Breaking
POST /v2/search/companies/preview
  • Removing a resource is always breaking unless it was deprecated before
    Breaking
1 structure change including:
1 Addition
Added 1
POST /v2/search/companies/preview
8 structure changes including:
8 Modifications
Modified 8 Breaking
POST /v2/enrich/person
  • Response
  • 200 response Modified
    • application/json content type Modified
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • string-1 property Added
POST /v2/search/companies
  • Body
  • application/json content type Modified
    • PeopleFilters property Modified
      • array-1 property Added
POST /v2/search/people
  • Body
  • application/json content type Modified
    • PeopleFilters property Modified
      • array-1 property Added
  • Response
  • 200 response Modified
    • application/json content type Modified
      • people property Modified
        • string-1 property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
        • string-1 property Added
POST /v3/search/people
  • Body
  • application/json content type Modified
    • PeopleFiltersV2 property Modified
      • array-1, array-1 properties Modified
        • Properties are now deprecated
      • lookalikeLinkedinHandles property Modified
        • Type went from array[string] | null to array[string]
          Breaking
      • array-1 property Added
    • CompaniesFiltersV2 property Modified
      • IndustriesFilter property Modified
        • Type went from array[string] | null to object | null
          Breaking
        • industries, mode properties Added
  • Response
  • 200 response Modified
    • application/json content type Modified
      • people property Modified
        • string-1 property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
        • string-1, company properties Added
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
Webhook POST enrich_person_email
  • Body
  • application/json content type Modified
    • string-1 property Removed
      • Removing a resource is always breaking unless it was deprecated before
        Breaking
    • string-1 property Added
Webhook POST enrich_person_phone
  • Body
  • application/json content type Modified
    • string-1 property Removed
      • Removing a resource is always breaking unless it was deprecated before
        Breaking
    • string-1 property Added
Webhook POST people_search_emails
  • Body
  • application/json content type Modified
    • people property Modified
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • string-1 property Added
Webhook POST people_search_phones
  • Body
  • application/json content type Modified
    • people property Modified
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • string-1 property Added
8 structure changes including:
8 Modifications
Modified 8 Breaking
POST /v2/enrich/person
  • Response
  • 200 response Modified
    • application/json content type Modified
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • string-1 property Added
POST /v2/search/companies
  • Body
  • application/json content type Modified
    • PeopleFilters property Modified
      • array-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
POST /v2/search/people
  • Body
  • application/json content type Modified
    • PeopleFilters property Modified
      • array-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
  • Response
  • 200 response Modified
    • application/json content type Modified
      • people property Modified
        • string-1 property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
        • string-1 property Added
POST /v3/search/people
  • Body
  • application/json content type Modified
    • PeopleFiltersV2 property Modified
      • array-1, array-1 properties Modified
        • Properties are no longer deprecated
      • array-1 property Modified
        • Type went from array[string] to array[string] | null
      • array-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
    • CompaniesFiltersV2 property Modified
      • array-1 property Modified
        • Type went from object | null to array[string] | null
          Breaking
        • industries, mode properties Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
  • Response
  • 200 response Modified
    • application/json content type Modified
      • people property Modified
        • string-1, company properties Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
        • string-1 property Added
      • string-1 property Added
Webhook POST enrich_person_email
  • Body
  • application/json content type Modified
    • string-1 property Removed
      • Removing a resource is always breaking unless it was deprecated before
        Breaking
    • string-1 property Added
Webhook POST enrich_person_phone
  • Body
  • application/json content type Modified
    • string-1 property Removed
      • Removing a resource is always breaking unless it was deprecated before
        Breaking
    • string-1 property Added
Webhook POST people_search_emails
  • Body
  • application/json content type Modified
    • people property Modified
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • string-1 property Added
Webhook POST people_search_phones
  • Body
  • application/json content type Modified
    • people property Modified
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • string-1 property Added
8 structure changes including:
8 Modifications
Modified 8 Breaking
POST /v2/enrich/person
  • Response
  • 200 response Modified
    • application/json content type Modified
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • string-1 property Added
POST /v2/search/companies
  • Body
  • application/json content type Modified
    • PeopleFilters property Modified
      • array-1 property Added
POST /v2/search/people
  • Body
  • application/json content type Modified
    • PeopleFilters property Modified
      • array-1 property Added
  • Response
  • 200 response Modified
    • application/json content type Modified
      • people property Modified
        • string-1 property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
        • string-1 property Added
POST /v3/search/people
  • Body
  • application/json content type Modified
    • PeopleFiltersV2 property Modified
      • array-1, array-1 properties Modified
        • Properties are now deprecated
      • lookalikeLinkedinHandles property Modified
        • Type went from array[string] | null to array[string]
          Breaking
      • array-1 property Added
    • CompaniesFiltersV2 property Modified
      • IndustriesFilter property Modified
        • Type went from array[string] | null to object | null
          Breaking
        • industries, mode properties Added
  • Response
  • 200 response Modified
    • application/json content type Modified
      • people property Modified
        • string-1 property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
        • string-1, company properties Added
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
Webhook POST enrich_person_email
  • Body
  • application/json content type Modified
    • string-1 property Removed
      • Removing a resource is always breaking unless it was deprecated before
        Breaking
    • string-1 property Added
Webhook POST enrich_person_phone
  • Body
  • application/json content type Modified
    • string-1 property Removed
      • Removing a resource is always breaking unless it was deprecated before
        Breaking
    • string-1 property Added
Webhook POST people_search_emails
  • Body
  • application/json content type Modified
    • people property Modified
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • string-1 property Added
Webhook POST people_search_phones
  • Body
  • application/json content type Modified
    • people property Modified
      • string-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • string-1 property Added
2 structure changes including:
2 Modifications
Modified 2
POST /v2/search/companies
  • Body
  • application/json content type Modified
    • CompaniesFilters property Modified
      • array-1 property Added
POST /v2/search/people
  • Body
  • application/json content type Modified
    • CompaniesFilters property Modified
      • array-1 property Added
7 structure changes including:
7 Modifications
Modified 7
POST /v2/enrich/person
  • Response
  • 200 response Modified
    • application/json content type Modified
      • Phone-Output, Email-Output properties Added
POST /v2/search/people
  • Response
  • 200 response Modified
    • application/json content type Modified
      • people property Modified
        • Phone-Output, Email-Output properties Added
POST /v3/search/people
  • Response
  • 200 response Modified
    • application/json content type Modified
      • people property Modified
        • Phone-Output, Email-Output properties Added
Webhook POST enrich_person_email
  • Body
  • application/json content type Modified
    • models__public_person__Phone property Added
Webhook POST enrich_person_phone
  • Body
  • application/json content type Modified
    • models__public_person__Email property Added
Webhook POST people_search_emails
  • Body
  • application/json content type Modified
    • people property Modified
      • models__public_person__Phone property Added
Webhook POST people_search_phones
  • Body
  • application/json content type Modified
    • people property Modified
      • models__public_person__Email property Added
9 structure changes including:
9 Modifications
Modified 9
GET /v2/data-fields
  • Response
  • 403 response Added
POST /v2/autocomplete/companies
  • Response
  • 402 response Added
POST /v2/enrich/company
  • Response
  • 400, 402 responses Added
POST /v2/enrich/person
  • Response
  • 400, 402 responses Added
POST /v2/reveal/emails
  • Response
  • 402 response Added
POST /v2/reveal/phones
  • Response
  • 402 response Added
POST /v2/search/companies
  • Response
  • 402 response Added
POST /v2/search/people
  • Response
  • 402 response Added
POST /v3/search/people
  • Response
  • 402 response Added
7 structure changes including:
7 Modifications
Modified 7 Breaking
POST /v2/enrich/person
  • Response
  • 200 response Modified
    • application/json content type Modified
      • string-1 property Added
POST /v2/search/people
  • Response
  • 200 response Modified
    • application/json content type Modified
      • people property Modified
        • string-1 property Added
POST /v3/search/people
  • Body
  • application/json content type Modified
    • PeopleFiltersV2 property Modified
      • array-1 property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • array-1 property Added
  • Response
  • 200 response Modified
    • application/json content type Modified
      • people property Modified
        • string-1 property Added
Webhook POST enrich_person_email
  • Body
  • application/json content type Modified
    • string-1 property Added
Webhook POST enrich_person_phone
  • Body
  • application/json content type Modified
    • string-1 property Added
Webhook POST people_search_emails
  • Body
  • application/json content type Modified
    • people property Modified
      • string-1 property Added
Webhook POST people_search_phones
  • Body
  • application/json content type Modified
    • people property Modified
      • string-1 property Added
1 structure change including:
1 Modification
Modified 1
POST /v3/search/people
  • Body
  • application/json content type Modified
    • PeopleFiltersV2 property Modified
      • array-1 property Added
1 structure change including:
1 Addition
Added 1
POST /v3/search/people
2 structure changes including:
2 Modifications
Modified 2 Breaking
POST /v2/search/companies
  • Response
  • 200 response Modified
    • application/json content type Modified
      • object-1 property Modified
        • * property Removed
          • Removing a resource is always breaking unless it was deprecated before
            Breaking
POST /v2/warmup/companies
  • Response
  • 200 response Modified
    • application/json content type Modified
      • object-1 property Added
11 structure changes including:
1 Breaking change
4 Additions
6 Modifications
1 Removal
Modified 6 Breaking
GET /v2/credits/balance
  • Response
  • 200 response Modified
    • application/json content type Modified
      • oneTimeCredits property Removed
        • Removing a resource is always breaking unless it was deprecated before
          Breaking
      • credits, emailCredits, phoneCredits properties Added
POST /v2/autocomplete/companies
  • Body
  • application/json content type Modified
    • array-1 property Added
POST /v2/enrich/person
  • Body
  • application/json content type Modified
    • RevealPhones property Added
POST /v2/search/companies
  • Body
  • application/json content type Modified
    • CompaniesFilters property Modified
      • excludeIndustries, excludeIndustryCategories, array-1, array-1 properties Added
    • PeopleFilters property Modified
      • array-1 property Added
    • from property Added
  • Response
  • 200 response Modified
    • application/json content type Modified
      • object-1 property Added
POST /v2/search/people
  • Body
  • application/json content type Modified
    • PeopleFilters property Modified
      • array-1 property Added
    • CompaniesFilters property Modified
      • excludeIndustries, excludeIndustryCategories, array-1, array-1 properties Added
    • from, RevealPhones properties Added
POST /v2/warmup/companies
  • Response
  • 200 response Modified
    • application/json content type Modified
      • object-1 property Added
Removed 1 Breaking
POST /v2/create/me
  • Removing a resource is always breaking unless it was deprecated before
    Breaking
Added 4
POST /v2/reveal/phones
Webhook POST enrich_person_phone
Webhook POST people_search_phones
Webhook POST reveal_phones
1 structure change including:
1 Addition
Added 1
POST /v2/warmup/companies
1 structure change including:
1 Breaking change
1 Removal
Removed 1 Breaking
POST /v2/warmup/companies
  • Removing a resource is always breaking unless it was deprecated before
    Breaking
1 structure change including:
1 Addition
Added 1
POST /v2/warmup/companies
2 structure changes including:
2 Modifications
Modified 2
POST /v2/search/companies
  • Body
  • application/json content type Modified
    • peopleFilters property Modified
      • fieldsExist, fieldsNotExist properties Added
POST /v2/search/people
  • Body
  • application/json content type Modified
    • peopleFilters property Modified
      • fieldsExist, fieldsNotExist properties Added
2 structure changes including:
1 Addition
1 Modification
Modified 1
GET /v2/credits/balance
  • Response
  • 200 response Modified
    • application/json content type Modified
      • dailyLimitRateLeft, dailyLimitRateSecondsToReset properties Added
Added 1
POST /v2/create/me
5 structure changes including:
1 Addition
4 Modifications
Modified 4 Breaking
GET /v2/data-fields
  • Response
  • 200 response Modified
    • application/json content type Modified
      • industries, technologies properties Modified
POST /v2/autocomplete/companies
  • Body
  • application/json content type Modified
    • name property Modified
      • Property is now required
        Breaking
      • name property Modified
        • Property is now required
          Breaking
POST /v2/enrich/company
  • Body
  • application/json content type Modified
    • company property Modified
      • name, registrationNumber, email, phone, countryCode, state, city, streetAddress, postalCode, address, facebook, twitter, linkedin, instagram, xing, domain, youtube properties Modified
        • Combinator is now anyOf
POST /v2/enrich/person
  • Body
  • application/json content type Modified
    • company property Modified
      • name, registrationNumber, email, phone, countryCode, state, city, streetAddress, postalCode, address, facebook, twitter, linkedin, instagram, xing, domain, youtube properties Modified
        • Combinator is now anyOf
    • revealEmails property Added
Added 1
Webhook POST enrich_person_email