Ready Signal API Documentation

Instructions on how to use Ready Signal API. Location of API end points, how to get access tokens, how to call API.

Ready Signal API

The Ready Signal API is designed to let you retrieve the processed data from one of your Signals.

Production Endpoint: https://app.readysignal.com/api/

1. Get an Access Token

To access the Ready Signal API, you have to get an access token and send it through your request's authorization header.

Scroll the page down to the API Credentials section, and use the button next to the Access Token to copy your token.

That's it. You will use that token to authenticate your next requests.

API Credentials-1

2. GET My Signals

To get the list of your signals.

Request	GET /signals
Headers	Accept	application/json
Headers	Authorization	Bearer {token}

Request

GET /api/signals HTTP/1.1

Host: app.readysignal.com

Content-Type: application/json

Accept: application/json

Authorization: Bearer eyJ0eXAiOiJKV1QiLCI1N...bGciOiJSUzI1Nmqhi6A

Response

{

   "data": [

       {

           "id": 48,

           "name": "My Signal Name",

           "description": "The description of my signal.",

           "desired_geo_grain": "State",

           "desired_time_grain": "Week",

           "start_at": "01/26/2020",

           "end_at": "05/31/2020",

           "created_at": "06/03/2020",

           "updated_at": "06/03/2020",

           "deleted_at": null,

           "company": {

               "id": 1024,

               "name": "Ready Signal Team",

               "plan_id": 1,

               "plan_value_id": 1,

               "subscription_status": "active",

               "created_at": "2020-05-11 18:39:24",

               "updated_at": "2020-05-11 18:40:22",

               "need_listining_webhook": 0

           },

           "user": {

               "id": 1015,

               "company_id": 1024,

               "name": "Marco Tanaka",

               "email": "marco@example.com",

               "type": "owner",

               "created_at": "2020-05-11 18:39:24",

               "updated_at": "2020-05-11 18:39:24"

           },

           "industry": {

               "id": 2,

               "name": "CPG",

               "created_at": "2020-04-10 23:21:39",

               "updated_at": "2020-04-10 23:21:39"

           },

           "analysis_type": {

               "id": 3,

               "name": "Classification",

               "created_at": "2020-04-10 23:21:45",

               "updated_at": "2020-04-10 23:21:45"

           },

           "output": {

               "json": "https://app.readysignal.com/api/signals/48/output?format=json"

           },

           "links": {

               "self": "https://app.readysignal.com/signal/48/manage",

               "manage": "https://app.readysignal.com/signal/48/manage"

           }

       }

   ],

}

3. GET My Signals Detail

To get the detail of the specified signal.

Request	GET /signals/{Signal_ID}/
Headers	Accept	application/json
Headers	Authorization	Bearer {token}

Request

GET /api/signals/48 HTTP/1.1

Host: app.readysignal.com

Content-Type: application/json

Accept: application/json

Authorization: Bearer eyJ0eXAiOiJKV1QiLCI1N...bGciOiJSUzI1Nmqhi6A

Response

{

   "data": {

       "id": 48,

       "name": "My Signal Name",

       "description": "The description of my signal.",

       "desired_geo_grain": "State",

       "desired_time_grain": "Week",

       "start_at": "01/26/2020",

       "end_at": "05/31/2020",

       "created_at": "06/03/2020",

       "updated_at": "06/03/2020",

       "deleted_at": null,

       "company": {

           "id": 1024,

           "name": "Ready Signal Team",

           "plan_id": 1,

           "plan_value_id": 1,

           "subscription_status": "active",

           "created_at": "2020-05-11 18:39:24",

           "updated_at": "2020-05-11 18:40:22",

           "need_listining_webhook": 0

       },

       "user": {

           "id": 1015,

           "company_id": 1024,

           "name": "Marco Tanaka",

           "email": "marco@example.com",

           "email_verified_at": null,

           "type": "owner",

           "created_at": "2020-05-11 18:39:24",

           "updated_at": "2020-05-11 18:39:24"

       },

       "industry": {

           "id": 2,

           "name": "CPG",

           "created_at": "2020-04-10 23:21:39",

           "updated_at": "2020-04-10 23:21:39"

       },

       "analysis_type": {

           "id": 3,

           "name": "Classification",

           "created_at": "2020-04-10 23:21:45",

           "updated_at": "2020-04-10 23:21:45"

       },

       "output": {

           "json": "https://app.readysignal.com/api/signals/48/output?format=json"

       },

       "links": {

           "self": "https://app.readysignal.com/signal/48/manage",

           "manage": "https://app.readysignal.com/signal/48/manage"

       }

   }

}

4. GET My Signal Output

To get the output of the specified signal.

The resulting data is paginated every 1000 records. You can use the "page" query string to get data from other pages. You can also see other pagination metadata on the JSON payload.

Request	GET /signals/{Signal_ID}/output
Query Strings	Page	Integer \| Optional \| The number of the pagination page
Headers	Accept	application/json
Headers	Authorization	Bearer {token}

Request

GET /api/signals/48/output?page=1 HTTP/1.1

Host: app.readysignal.com

Content-Type: application/json

Accept: application/json

Authorization: Bearer eyJ0eXAiOiJKV1QiLCI1N...bGciOiJSUzI1Nmqhi6A

Response

{

       "current_page": 1,

       "data": [

       {

             "start": "2020-01-26",

             "end": "2020-02-01",

             "state": "Alabama",

             "population-rural": "1957932.00000000000000000000"

       },

       {

             "start": "2020-01-26",

             "end": "2020-02-01",

             "state": "Alaska",

             "population-rural": "241338.00000000000000000000"

       },

       {…},

       {

             "start": "2020-05-24",

             "end": "2020-05-30",

             "state": "Puerto Rico",

             "population-rural": "232533.00000000000000000000"

       }

       ],

       "first_page_url": "https://app.readysignal.com/api/signals/48/output?page=1",

       "from": 1,

       "last_page": 1,

       "last_page_url": "https://app.readysignal.com/api/signals/48/output?page=1",

       "next_page_url": null,

       "path": "https://app.readysignal.com/api/signals/48/output",

       "per_page": 1000,

       "prev_page_url": null,

       "to": 936,

       "total": 936

}