LogoLogo
LogoLogo
  • Overview & Changelog
    • Minerva Documentation
    • Data Dictionary
    • Changelog
  • Authentication
    • OAuth 2.0 Authentication
  • People Data
    • Identity Resolution
    • Enrichment
    • Contact Data From LinkedIn URL
  • Specification
Powered by GitBook
On this page
Export as PDF
  1. Authentication

OAuth 2.0 Authentication

Authentication methods

PreviousChangelogNextIdentity Resolution

Last updated 2 months ago

Obtain a Minerva OAuth authentication token

post

Authenticates the user with username, password and client_id using the OAuth method. Returns an minerva_api_oauth_token on success. minerva_api_oauth_token is the Bearer token used for authenticating all of Minerva's services that are whitelisted for the user.

Authorizations
Header parameters
Content-TypestringRequiredExample: application/json
usernamestringRequired

email address: all lowercase

Example: mj@minerva.io
passwordstringRequired

64 characters: numbers, upper/lower case, special characters

Example: bPkyh@CPmBmEddUJ4LBuH7AtaoUGL6mq8z@WH!*2pVjjpzxv*xquBzyVvHJyoiUq
client_idstringRequired

26 characters: numbers, upper/lower case

Example: 3238asdftt2d80pk2mcq
Responses
200
Successfully authenticated, returns the `minerva_api_oauth_token`
application/json
400
Invalid request
401
Unauthorized
post
curl -i -X POST \
  https://api.minerva.io/v1/get-token \
  -H 'Content-Type: application/json' \
  -H 'username: mj@minerva.io' \
  -H 'password: bPkyh@CPmBmEddUJ4LBuH7AtaoUGL6mq8z@WH!*2pVjjpzxv*xquBzyVvHJyoiUq' \
  -H 'client_id: 3238asdftt2d80pk2mcq'
{
  "minerva_api_oauth_token": "eyJsd3ft...s80pk2mcq"
}