The most basic way to interact with the Parrot by Pagos BIN service is via the Command Line Interface (CLI).

Setup

Before you get started, you'll need the following:

A Pagos API Key: You'll use this when you send a request for data to Parrot
The Parrot API endpoing: https://parrotv2.prod.pagosapi.com/
cURL installed on your machine

Next, confirm cURL is installed in your terminal application.

curl --version

You should see output similar to below. The version itself isn’t important for our service at this time.

super-computer ~ % curl --version
curl 7.64.1 (x86_64-apple-darwin20.0) libcurl/7.64.1 (SecureTransport) LibreSSL/2.8.3 zlib/1.2.11 nghttp2/1.41.0
Release-Date: 2019-03-27
Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 pop3s rtsp smb smbs smtp smtps telnet tftp 
Features: AsynchDNS GSS-API HTTP2 HTTPS-proxy IPv6 Kerberos Largefile libz MultiSSL NTLM NTLM_WB SPNEGO SSL UnixSockets

Make a request

To receive the JSON data for a BIN, make a request using your API key and the desired BIN number:

curl -H "x-api-key: [your API key]"  "https://parrotv2.prod.pagosapi.com/cards?bin=[BIN/IIN number]"

Here’s the output for example BIN 510084

That’s it! From here you can use various programming languages to pull the data into your systems.