NLT API Usage Documentation
The NLT API is based on HTTP GET requests with all parameters in the URL (unless noted as POST request). The output format is HTML (unless noted as, e.g., JSON).
Your API key is included in each request with the key query parameter. If key=TEST or omitted, then your IP address will be used as a key, and you will be limited to 50 verses per request and 500 requests per day.
Return the Scripture text for the given passages, ordered by reference, as an HTML excerpt that can readily be included in a web page.
- Example: https://api.nlt.to/api/passages?ref=John.1&key=TEST
ref The reference(s) for the passages to be returned. More than one reference can be given, separated by semi-colons or commas. version The Bible version to show. (Default version=NLT.) Available values: NLT NLT (American English) NLTUK NLT (UK English) NTV Nueva Traducción Viviente KJV King James Version key Your API license key.
Return search results (passages and short context paragraphs) for the given search query terms.
- Example: https://api.nlt.to/api/search?text=mother+and+father&key=TEST
text The text to search for. version The Bible version to search. (Default version=NLT.) key Your API license key.
Return a parsed list of references for the given reference string. NOTE: the Content-Type for this query is always JSON.
- Example: https://api.nlt.to/api/parse?ref=John.1&key=TEST
ref The reference string to parse. key Your API license key. language The language. (Default language=en. Spanish is 'es')
Return a list of reading plans supported by the API.
- Example: https://api.nlt.to/api/plans?key=TEST
key Your API license key.
Return the text for a given date in the given reading plan. (Default date=today.)
- Example: https://api.nlt.to/api/reading?plan=OYB&key=TEST
plan The name of the reading plan from which to retrieve the reading. The plan name should exactly match one of the reading plan names listed in https://api.nlt.to/plans date The date of the reading. (Default date=today.) version The Bible version in which to provide the reading. key Your API license key.