Get the daily YouVersion Bible verse selections for calendar days. Get the full year's verse calendar, or get the verse for a specific day.
Get the verse of the day calendar for an entire year.
January 1 is day 1 and December 31 is day 365 (or 366 in a leap year).
language_ranges[] selects the language of the verse art. The endpoint tries ranges in order. It uses the first range that has art for the calendar (es-MX falls back to es, and * selects English).
The image_id of each item is an id that the system issues for this response. Resolve it with GET /v1/images/{image_id} to get the metadata and CDN image_url of the art. The id has a value when art exists. It is null when no range has art or you omit the parameter. The endpoint returns the text response either way. A response that carries an image_id is private to the caller.
query Parameters
language_ranges[]An ordered list of language ranges using bracket notation. Use repeated parameters like language_ranges[]=en&language_ranges[]=es to supply multiple ranges, and use the wildcard * to match all languages. Ranges are tried in the order given. Optional; each operation's description states what is returned when it is omitted. A language range is much like a language tag but may contain wildcards. See RFC 4647 section 2 for the full definition: https://www.rfc-editor.org/rfc/rfc4647.html#section-2
Language ranges in this parameter may only be of the Basic Range format.
Get the verse of the day calendar for an entire year. › Responses
Successful request
Get the verse of the day for a specific day of the year.
Day is the day of the year (1-366).
language_ranges[] selects the language of the verse art. The endpoint tries ranges in order. It uses the first range that has art for the calendar (es-MX falls back to es, and * selects English).
The image_id of each item is an id that the system issues for this response. Resolve it with GET /v1/images/{image_id} to get the metadata and CDN image_url of the art. The id has a value when art exists. It is null when no range has art or you omit the parameter. The endpoint returns the text response either way. A response that carries an image_id is private to the caller.
path Parameters
dayThe day of the year (1-366)
query Parameters
language_ranges[]An ordered list of language ranges using bracket notation. Use repeated parameters like language_ranges[]=en&language_ranges[]=es to supply multiple ranges, and use the wildcard * to match all languages. Ranges are tried in the order given. Optional; each operation's description states what is returned when it is omitted. A language range is much like a language tag but may contain wildcards. See RFC 4647 section 2 for the full definition: https://www.rfc-editor.org/rfc/rfc4647.html#section-2
Language ranges in this parameter may only be of the Basic Range format.
Get the verse of the day for a specific day of the year. › Responses
Successful request
daypassage_idThe passage identifier
image_idAn opaque image id, issued for this response, for this day's verse art in the language selected by language_ranges[]. Resolve it with GET /v1/images/{image_id} for the art's metadata and CDN image_url. Ids are issued per response, so the same art can carry a different id in each response; do not use it as a stable key. Null when language_ranges[] was omitted or no art exists for the requested ranges.