Categories API lets you manage your categories.

GET

Retrieve a list of your categories.

URI Parameter Required Requirements Description
category No A string Performs a prefix search on this value.
limit No Some integer. Optional field to limit the number of results returned. Defaults to 50.
offset No Some integer. Optional beginning point in the list to retrieve from. Defaults to 0.

Request

1
GET https://api.sendgrid.com/v3/categories HTTP/1.1

Response

1
2
3
4
5
6
7
8
HTTP/1.1 200
[
  {"category": "cat1"},
  {"category": "cat2"},
  {"category": "cat3"},
  {"category": "cat4"},
  {"category": "cat5"}
]