{"openapi":"3.2.0","info":{"title":"Faith promises API","description":"Faith Promises API provides Scripture-based tools for applications that want to integrate Bible verses, faith promises, declarations, prayers, daily encouragement, and AI-guided biblical responses. Developers can retrieve Bible verses across multiple translations, search Scripture, explore curated promises by category or topic, receive a daily promise, and generate personalized faith-based responses from a user's situation. The API is designed for Christian apps, prayer applications, devotional platforms, Bible study tools, church applications, inspirational products, and AI-powered faith experiences.","version":"1.0.0"},"servers":[{"url":"https://vfytj.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Promises"},{"name":"Search"}],"x-agent-commerce":{"catalog_url":"https://vfytj.jojapi.net/_jojapi/agent/plans","discovery_url":"https://vfytj.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/faith-promises-api","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/promises":{"get":{"operationId":"get_promises","summary":"/promises","description":"Returns available faith promises from the Faith Promises collection.  Each promise can include Scripture references, the promise statement, faith declaration, prayer, and related category information.","tags":["Promises"],"responses":{"200":{"description":"Matching faith promises","content":{"application/json":{"examples":{"Example_1":{"value":{}}}}}},"402":{"description":"Payment required — pay per request with x402/mpp (offer in the PAYMENT-REQUIRED / WWW-Authenticate headers and the JSON body), or send a JoJ API key."}},"x-payment-info":{"protocols":["x402","mpp"],"price":{"mode":"fixed","currency":"USD","amount":"1"},"intent":"charge"},"parameters":[{"name":"category","in":"query","description":"Promise category","required":false,"schema":{"type":"string"}},{"name":"topic","in":"query","description":"Topic or natural-language situation such as peace, marriage, career, finances, fear, or guidance.","required":false,"schema":{"type":"string"}}]}},"/search":{"get":{"operationId":"get_search","summary":"/search","description":"enter the relevant text to to be matched to your topic in scripture.","tags":["Search"],"responses":{"200":{"description":"Matching Bible verses","content":{"application/json":{"examples":{"Example_1":{"value":{}}}}}},"402":{"description":"Payment required — pay per request with x402/mpp (offer in the PAYMENT-REQUIRED / WWW-Authenticate headers and the JSON body), or send a JoJ API key."}},"x-payment-info":{"protocols":["x402","mpp"],"price":{"mode":"fixed","currency":"USD","amount":"1"},"intent":"charge"},"parameters":[{"name":"q","in":"query","description":"Search phrase","required":true,"schema":{"type":"string"}},{"name":"version","in":"query","required":false,"schema":{"type":"string","example":"kjv","default":"kjv"}},{"name":"limit","in":"query","required":false,"schema":{"type":"number","example":20,"default":20}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}