[GET] Get taxonomies

Modified on Tue, 11 Feb at 3:43 AM

Get taxonomies

This endpoint provides the information about our new taxonomy schema. Sub-taxonomies are nested within each main taxonomy under the subTaxonomies array. Taxonomies and sub-taxonomies can be used to filter News items allowing consumers to reach into our news data in a more effective way.

HTTP Request

curl -X GET 'https://news.s7risk.com/taxonomies' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {{YOUR_AUTHENTICATION_TOKEN}}' \
  --compressed

Headers

NameTypeRequiredDescription
Authorizationstring✔️Your authentication token (see the Auth API section for more information)

HTTP Response

{
    "status": "success",
    "data": {
        "taxonomies": [
            {
                "id": "606e8a19-660c-4aef-bbe2-8dd84e2e474d",
                "name": "Propaganda",
                "subTaxonomies": []
            },
            {
                "id": "f6e9b8a1-f1e1-4488-a43a-84a27bd0516b",
                "name": "Transportation Safety",
                "subTaxonomies": [
                    {
                        "id": "4da372b1-a5e7-413e-8d0a-2135a24f9156",
                        "name": "Air Safety"
                    },
                    {
                        "id": "b0459a97-5874-4064-8263-19f6c6b1be99",
                        "name": "Air Traffic Control"
                    }
                ]
            }
        ]
    }
}

Success

CodeStatusDescription
200SuccessReturns a body containing all valid Taxonomies.

Errors

CodeStatusDescription
401UnauthorizedExpired or Invalid Authentication token

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article