Characters

List all characters

You can access the list of characters by using the /characters endpoint. This endpoint supports pagination to retrieve characters in batches.

Method & URL

GET

https://bb-bc-api.vercel.app/api/v1/characters

Response Example

{
  "rows": [
    {
      "_id": "686a8c85ee3aeb40d3bdedf0",
      "name": "Walter White",
      "birthday": "1958-09-07",
      "occupation": [
        "High School Chemistry Teacher",
        "Meth King Pin"
      ],
      "image": "https://images.amcnetworks.com/amc.com/wp-content/uploads/2015/04/cast_bb_700x1000_walter-white-lg.jpg",
      "status": "Presumed dead",
      "nickname": "Heisenberg",
      "appearance": [
        1,
        2,
        3,
        4,
        5
      ],
      "portrayed": "Bryan Cranston",
      "category": "Breaking Bad",
      "betterCallSaulAppearance": [],
      "__v": 0,
      "createdAt": "2025-07-06T14:47:33.801Z",
      "updatedAt": "2025-07-06T14:47:33.801Z"
    }
  ],
  "metadata": {
    "total": 63,
    "page": 1,
    "limit": 1,
    "totalPages": 63
  }
}

Get character by id

You can get a specific character by using the /characters/{id} endpoint.

Method & URL

GET

https://bb-bc-api.vercel.app/api/v1/characters/{id}

Response Example

{
  "_id": "686a8c85ee3aeb40d3bdedf1",
  "name": "Jesse Pinkman",
  "birthday": "1984-09-24",
  "occupation": [
    "Meth Dealer"
  ],
  "image": "https://upload.wikimedia.org/wikipedia/en/thumb/f/f2/Jesse_Pinkman2.jpg/220px-Jesse_Pinkman2.jpg",
  "status": "Alive",
  "nickname": "Cap n' Cook",
  "appearance": [
    1,
    2,
    3,
    4,
    5
  ],
  "portrayed": "Aaron Paul",
  "category": "Breaking Bad",
  "betterCallSaulAppearance": [],
  "__v": 0,
  "createdAt": "2025-07-06T14:47:33.801Z",
  "updatedAt": "2025-07-06T14:47:33.801Z"
}