Chuck Norris Joke API

Operations

Categories

This operation returns a list of joke categories available through the joke API.

• URL: http://api.icndb.com/categories
• Sample Response:

  { "type": "success", "value": [ "nerdy", "explicit" ] }

Joke list size

This operation returns the total number of jokes available through this API.

• URL: http://api.icndb.com/jokes/count
• Sample Response:

  { "type": "success", "value": 546 }

Get a joke by id

This operation returns a single job by the joke id passed in.

• URL: http://api.icndb.com/jokes/<joke id>
• Response:

  { "type": "success", "value": { "id": 15, "joke": "When Chuck Norris goes to donate blood, he
  declines the syringe, and instead requests a hand gun and a bucket.", "categories": [] } }

Fetching a random joke

This operation returns one or more random jokes

Single joke

• URL: http://api.icndb.com/jokes/random
• Sample Response:

  { "type": "success", "value": { "id": 340, "joke": "A man once claimed Chuck Norris
  kicked his ass twice, but it was promptly dismissed as false - no one could survive it the first time.",
  "categories": [] } }

Multiple jokes

• URL: http://api.icndb.com/jokes/random/<number of jokes>
• Sample Response:

  { "type": "success", "value": [ { "id": 507, "joke": "Chuck Norris can install iTunes
  without installing Quicktime.", "categories": ["nerdy"] }, { "id": 97, "joke": "Chuck Norris doesn't throw up if
  he drinks too much. Chuck Norris throws down!", "categories": [] }, { "id": 424, "joke": "Chuck Norris has
  volunteered to remain on earth after the Rapture; he will spend his time fighting the Anti-Christ.",
  "categories": [] } ]  }