{
  "openapi": "3.1.0",
  "info": {
    "title": "Bible Multi-Translation API",
    "version": "1.0.0",
    "description": "Verses from multiple Bible translations by book, chapter and verse, with version metadata.\n\nLook up any verse across multiple Bible translations, browse the 66 books and chapters, and read each version's metadata. Built for devotional apps, study tools and content sites.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/bible.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/bible-multi-translation"
  },
  "servers": [
    {
      "url": "https://api-bible.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Religion",
      "description": "Bible Multi-Translation API belongs to the Religion category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/versions/{versionCode}/books/{bookCode}/chapters/{chapter}/verses/{verse}": {
      "get": {
        "operationId": "getSingleVerse",
        "summary": "Get Single Verse",
        "description": "Get Single Verse endpoint of the Bible Multi-Translation API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/bible-multi-translation/get-single-verse"
        },
        "parameters": [
          {
            "name": "bookCode",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "GEN"
          },
          {
            "name": "chapter",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "verse",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "versionCode",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "kjv"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "data": {
                    "chapter": 1,
                    "verse": 1,
                    "text": "In the beginning God created the heaven and the earth.",
                    "bookCode": "GEN",
                    "bookName": "Genesis",
                    "versionCode": "kjv",
                    "versionName": "King James Version"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/versions/{code}": {
      "get": {
        "operationId": "getTranslationDetails",
        "summary": "Get Translation Details",
        "description": "Get Translation Details endpoint of the Bible Multi-Translation API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/bible-multi-translation/get-translation-details"
        },
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "blb"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "data": {
                    "id": 13,
                    "code": "blb",
                    "name": "Berean Literal Bible",
                    "language": "English",
                    "languageCode": "en",
                    "year": 2020,
                    "publisher": "Bible Hub",
                    "license": "Public Domain",
                    "description": "A highly literal translation of the New Testament, intended to be a companion to interlinear study."
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/books": {
      "get": {
        "operationId": "listBibleBooks",
        "summary": "List Bible Books",
        "description": "List Bible Books endpoint of the Bible Multi-Translation API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/bible-multi-translation/list-bible-books"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "data": [
                    {
                      "code": "GEN",
                      "name": "Genesis",
                      "testament": "OT",
                      "chapters": 50
                    },
                    {
                      "code": "EXO",
                      "name": "Exodus",
                      "testament": "OT",
                      "chapters": 40
                    },
                    {
                      "code": "LEV",
                      "name": "Leviticus",
                      "testament": "OT",
                      "chapters": 27
                    },
                    {
                      "code": "NUM",
                      "name": "Numbers",
                      "testament": "OT",
                      "chapters": 36
                    },
                    {
                      "code": "DEU",
                      "name": "Deuteronomy",
                      "testament": "OT",
                      "chapters": 34
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/versions": {
      "get": {
        "operationId": "listBibleTranslations",
        "summary": "List Bible Translations",
        "description": "List Bible Translations endpoint of the Bible Multi-Translation API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/bible-multi-translation/list-bible-translations"
        },
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "10"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "data": [
                    {
                      "id": 1,
                      "code": "kjv",
                      "name": "King James Version",
                      "language": "English",
                      "languageCode": "en",
                      "year": 1611
                    },
                    {
                      "id": 2,
                      "code": "niv",
                      "name": "New International Version",
                      "language": "English",
                      "languageCode": "en",
                      "year": 1978
                    },
                    {
                      "id": 3,
                      "code": "esv",
                      "name": "English Standard Version",
                      "language": "English",
                      "languageCode": "en",
                      "year": 2001
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "limit": 10,
                    "total": 13
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}