{ "openapi": "3.1.0", "info": { "title": "Pregnancy Calculator API", "version": "Unversioned", "description": "Estimate due dates, gestational weeks, fertility windows, cycle timing and IVF dates with related reproductive-health calculators.", "x-pricing-model": "payg", "x-free-tier-calls": 0, "x-docs-url": "", "x-dakidarts-contract-status": "published", "x-dakidarts-execution-status": "source-only" }, "servers": [ { "url": "https://api.dakidarts.com/pregnancy-calculator", "description": "Dakidarts direct gateway" } ], "tags": [ { "name": "Operations", "description": "Operations endpoints sourced from the Pregnancy Calculator API implementation." }, { "name": "Pregnancy calculations", "description": "Pregnancy calculations endpoints sourced from the Pregnancy Calculator API implementation." } ], "paths": { "/status": { "get": { "summary": "Ping", "description": "Returns Pregnancy Calculator service health.", "operationId": "pregnancy-calculator_get_status", "tags": [ "Operations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "example": { "status": "API is online" } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true, "x-dakidarts-sample-response": { "status": "API is online" } }, "post": { "summary": "Ping", "description": "Returns Pregnancy Calculator service health.", "operationId": "pregnancy-calculator_post_status", "tags": [ "Operations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "example": { "status": "API is online" } } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true, "x-dakidarts-sample-response": { "status": "API is online" } } }, "/dd/lmp": { "get": { "summary": "Calculate Due Date Lmp", "description": "Estimates due date and pregnancy stage from the last menstrual period.", "operationId": "pregnancy-calculator_get_dd_lmp", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "cycle_length", "in": "query", "required": true, "description": "Typical menstrual-cycle length in days.", "schema": { "type": "integer" } }, { "name": "last_period_date", "in": "query", "required": true, "description": "First day of the last menstrual period (YYYY-MM-DD).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "due_date": { "description": "Dynamic source value; no concrete response example is published." }, "trimester": { "description": "Dynamic source value; no concrete response example is published." }, "gestational_age": { "type": "integer" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/dd/lmp/post": { "post": { "summary": "Calculate Due Date Lmp Post", "description": "Estimates due date and pregnancy stage from JSON last-menstrual-period data.", "operationId": "pregnancy-calculator_post_dd_lmp_post", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "due_date": { "description": "Dynamic source value; no concrete response example is published." }, "trimester": { "description": "Dynamic source value; no concrete response example is published." }, "gestational_age": { "type": "integer" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "cycle_length": { "type": "integer", "example": 28 }, "last_period_date": { "type": "string", "example": "2026-01-01" } }, "required": [ "cycle_length", "last_period_date" ], "example": { "cycle_length": 28, "last_period_date": "2026-01-01" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/dd/conception": { "get": { "summary": "Calculate Due Date Conception", "description": "Estimates due date from the conception date.", "operationId": "pregnancy-calculator_get_dd_conception", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "conception_date", "in": "query", "required": true, "description": "Estimated conception date (YYYY-MM-DD).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "due_date": { "description": "Dynamic source value; no concrete response example is published." }, "trimester": { "description": "Dynamic source value; no concrete response example is published." }, "gestational_age": { "type": "integer" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/dd/conception/post": { "post": { "summary": "Calculate Due Date Conception Post", "description": "Estimates due date from JSON conception-date data.", "operationId": "pregnancy-calculator_post_dd_conception_post", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "due_date": { "description": "Dynamic source value; no concrete response example is published." }, "trimester": { "description": "Dynamic source value; no concrete response example is published." }, "gestational_age": { "type": "integer" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "conception_date": { "type": "string", "example": "2026-01-15" } }, "required": [ "conception_date" ], "example": { "conception_date": "2026-01-15" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/pw/lmp": { "get": { "summary": "Calculate Pregnancy Week", "description": "Calculates pregnancy week and day from the last menstrual period.", "operationId": "pregnancy-calculator_get_pw_lmp", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "cycle_length", "in": "query", "required": true, "description": "Typical menstrual-cycle length in days.", "schema": { "type": "integer" } }, { "name": "last_period_date", "in": "query", "required": true, "description": "First day of the last menstrual period (YYYY-MM-DD).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "milestones": { "description": "Dynamic source value; no concrete response example is published." }, "current_day": { "type": "integer" }, "current_week": { "type": "integer" }, "common_symptoms": { "description": "Dynamic source value; no concrete response example is published." }, "fetal_development": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/pw/lmp/post": { "post": { "summary": "Calculate Pregnancy Week Lmp Post", "description": "Calculates pregnancy week and day from JSON last-menstrual-period data.", "operationId": "pregnancy-calculator_post_pw_lmp_post", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "milestones": { "description": "Dynamic source value; no concrete response example is published." }, "current_day": { "type": "integer" }, "current_week": { "type": "integer" }, "common_symptoms": { "description": "Dynamic source value; no concrete response example is published." }, "fetal_development": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "cycle_length": { "type": "integer", "example": 28 }, "last_period_date": { "type": "string", "example": "2026-01-01" } }, "required": [ "cycle_length", "last_period_date" ], "example": { "cycle_length": 28, "last_period_date": "2026-01-01" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/pw/conception": { "get": { "summary": "Calculate Pregnancy Week C", "description": "Calculates pregnancy week and day from the conception date.", "operationId": "pregnancy-calculator_get_pw_conception", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "conception_date", "in": "query", "required": true, "description": "Estimated conception date (YYYY-MM-DD).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "milestones": { "description": "Dynamic source value; no concrete response example is published." }, "current_day": { "type": "integer" }, "current_week": { "type": "integer" }, "common_symptoms": { "description": "Dynamic source value; no concrete response example is published." }, "fetal_development": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/pw/conception/post": { "post": { "summary": "Calculate Pregnancy Week C Post", "description": "Calculates pregnancy week and day from JSON conception-date data.", "operationId": "pregnancy-calculator_post_pw_conception_post", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "milestones": { "description": "Dynamic source value; no concrete response example is published." }, "current_day": { "type": "integer" }, "current_week": { "type": "integer" }, "common_symptoms": { "description": "Dynamic source value; no concrete response example is published." }, "fetal_development": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "conception_date": { "type": "string", "example": "2026-01-15" } }, "required": [ "conception_date" ], "example": { "conception_date": "2026-01-15" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/fw": { "get": { "summary": "Calculate Fertility Window", "description": "Calculates an estimated fertility window from menstrual date and cycle length.", "operationId": "pregnancy-calculator_get_fw", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "cycle_length", "in": "query", "required": true, "description": "Typical menstrual-cycle length in days.", "schema": { "type": "integer" } }, { "name": "menstrual_date", "in": "query", "required": true, "description": "First day of the last menstrual period (YYYY-MM-DD).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "fertility_window_end": { "description": "Dynamic source value; no concrete response example is published." }, "fertility_window_start": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/fw/post": { "post": { "summary": "Calculate Fertility Window Post", "description": "Calculates an estimated fertility window from JSON request data.", "operationId": "pregnancy-calculator_post_fw_post", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "fertility_window_end": { "description": "Dynamic source value; no concrete response example is published." }, "fertility_window_start": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "cycle_length": { "type": "integer" }, "menstrual_date": { "type": "string" } }, "required": [ "cycle_length", "menstrual_date" ], "example": { "cycle_length": 28, "menstrual_date": "2026-01-01" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/pwr": { "get": { "summary": "Calculate Pregnancy Weight Get", "description": "Estimates recommended pregnancy weight change from weight, height, and gestational age.", "operationId": "pregnancy-calculator_get_pwr", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "pre_pregnancy_weight", "in": "query", "required": true, "description": "Weight before pregnancy, in the unit specified by the endpoint.", "schema": { "type": "number" } }, { "name": "height", "in": "query", "required": true, "description": "Patient height, in the unit expected by the endpoint.", "schema": { "type": "number" } }, { "name": "gestational_age", "in": "query", "required": true, "description": "Gestational age in weeks.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "recommendation_type": { "description": "Dynamic source value; no concrete response example is published." }, "recommended_weight_change": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/pwr/post": { "post": { "summary": "Calculate Pregnancy Weight", "description": "Estimates recommended pregnancy weight change from JSON request data.", "operationId": "pregnancy-calculator_post_pwr_post", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "recommendation_type": { "description": "Dynamic source value; no concrete response example is published." }, "recommended_weight_change": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pre_pregnancy_weight": { "type": "number" }, "height": { "type": "number" }, "gestational_age": { "type": "integer" } }, "required": [ "gestational_age", "height", "pre_pregnancy_weight" ], "example": { "height": 1.65, "gestational_age": 20, "pre_pregnancy_weight": 65 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/trimester-calculator": { "get": { "summary": "Trimester Calc", "description": "Determines pregnancy trimester from the last menstrual period or due date.", "operationId": "pregnancy-calculator_get_trimester-calculator", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "lmp", "in": "query", "required": false, "description": "First day of the last menstrual period (YYYY-MM-DD).", "schema": { "type": "string" }, "x-required-group": "trimester-date" }, { "name": "due_date", "in": "query", "required": false, "description": "Estimated due date (YYYY-MM-DD).", "schema": { "type": "string" }, "x-required-group": "trimester-date" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "trimester_ranges": { "type": "object", "properties": { "First Trimester": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true }, "Third Trimester": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true }, "Second Trimester": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true } }, "additionalProperties": true }, "current_trimester": { "type": "string" }, "days_into_trimester": { "type": "integer" }, "days_left_in_trimester": { "type": "integer" } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Trimester Calc", "description": "Determines pregnancy trimester from the last menstrual period or due date.", "operationId": "pregnancy-calculator_post_trimester-calculator", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "trimester_ranges": { "type": "object", "properties": { "First Trimester": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true }, "Third Trimester": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true }, "Second Trimester": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true } }, "additionalProperties": true }, "current_trimester": { "type": "string" }, "days_into_trimester": { "type": "integer" }, "days_left_in_trimester": { "type": "integer" } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "lmp": { "type": "string", "x-required-group": "trimester-date" }, "due_date": { "type": "string", "x-required-group": "trimester-date" } }, "example": { "due_date": "2027-02-01" } } } } }, "x-required-groups": { "trimester-date": [ "lmp", "due_date" ] }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/bishop-score-calculator": { "get": { "summary": "Calculate Bishop Score", "description": "Calculates the Bishop score from cervical dilation, effacement, consistency, position, and station.", "operationId": "pregnancy-calculator_get_bishop-score-calculator", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "dilation", "in": "query", "required": true, "description": "Cervical dilation measurement.", "schema": { "type": "string", "enum": [ "closed", "1-2", "3-4", "5+" ] } }, { "name": "effacement", "in": "query", "required": true, "description": "Cervical effacement percentage.", "schema": { "type": "string", "enum": [ "0-30%", "40-50%", "60-70%", "80%+" ] } }, { "name": "consistency", "in": "query", "required": true, "description": "Cervical consistency category used by the Bishop score.", "schema": { "type": "string", "enum": [ "firm", "moderate", "soft" ] } }, { "name": "station", "in": "query", "required": true, "description": "Fetal station value used by the Bishop score.", "schema": { "type": "string", "enum": [ "-3", "-2", "-1/0", "+1/+2" ] } }, { "name": "position", "in": "query", "required": true, "description": "Cervical position category used by the Bishop score.", "schema": { "type": "string", "enum": [ "posterior", "mid", "anterior" ] } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "total_score": { "type": "integer" }, "interpretation": { "type": "string" } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Calculate Bishop Score", "description": "Calculates the Bishop score from cervical dilation, effacement, consistency, position, and station.", "operationId": "pregnancy-calculator_post_bishop-score-calculator", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "total_score": { "type": "integer" }, "interpretation": { "type": "string" } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dilation": { "type": "string", "enum": [ "closed", "1-2", "3-4", "5+" ] }, "effacement": { "type": "string", "enum": [ "0-30%", "40-50%", "60-70%", "80%+" ] }, "consistency": { "type": "string", "enum": [ "firm", "moderate", "soft" ] }, "station": { "type": "string", "enum": [ "-3", "-2", "-1/0", "+1/+2" ] }, "position": { "type": "string", "enum": [ "posterior", "mid", "anterior" ] } }, "required": [ "consistency", "dilation", "effacement", "position", "station" ], "example": { "station": "-1/0", "dilation": "3-4", "position": "mid", "effacement": "60-70%", "consistency": "moderate" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/mca-calculator": { "get": { "summary": "Calculate Mca", "description": "Interprets middle cerebral artery peak systolic velocity against gestational-age reference values.", "operationId": "pregnancy-calculator_get_mca-calculator", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "gestational_age", "in": "query", "required": true, "description": "Gestational age in weeks.", "schema": { "type": "integer" } }, { "name": "mca_psv", "in": "query", "required": true, "description": "Middle cerebral artery peak systolic velocity.", "schema": { "type": "number" } }, { "name": "pregnancy_type", "in": "query", "required": true, "description": "Pregnancy type, such as singleton or multiple.", "schema": { "type": "string", "default": "", "enum": [ "single", "twin" ] } }, { "name": "unit", "in": "query", "required": true, "description": "Unit for the supplied measurement.", "schema": { "type": "string", "default": "", "enum": [ "metric", "imperial" ] } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "mom": { "type": "number" }, "unit": { "type": "string" }, "input_mca_psv": { "type": "number" }, "interpretation": { "type": "string" }, "median_mca_psv": { "type": "number" }, "pregnancy_type": { "type": "string" }, "gestational_age": { "type": "integer" } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Calculate Mca", "description": "Interprets middle cerebral artery peak systolic velocity against gestational-age reference values.", "operationId": "pregnancy-calculator_post_mca-calculator", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "mom": { "type": "number" }, "unit": { "type": "string" }, "input_mca_psv": { "type": "number" }, "interpretation": { "type": "string" }, "median_mca_psv": { "type": "number" }, "pregnancy_type": { "type": "string" }, "gestational_age": { "type": "integer" } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "gestational_age": { "type": "integer" }, "mca_psv": { "type": "number" }, "pregnancy_type": { "type": "string", "default": "", "enum": [ "single", "twin" ] }, "unit": { "type": "string", "default": "", "enum": [ "metric", "imperial" ] } }, "required": [ "gestational_age", "mca_psv", "pregnancy_type", "unit" ], "example": { "unit": "metric", "mca_psv": 35.0, "pregnancy_type": "single", "gestational_age": 20 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ivf-due-date": { "get": { "summary": "Calculate Ivf Due Date", "description": "Estimates an IVF due date from embryo-transfer date and transfer type.", "operationId": "pregnancy-calculator_get_ivf-due-date", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "transfer_type", "in": "query", "required": true, "description": "Embryo-transfer stage/type used for IVF dating.", "schema": { "type": "string", "enum": [ "Day-3 embryo transfer", "Day-5 embryo transfer", "IVF with own eggs", "IVF with donor eggs cycle" ] } }, { "name": "transfer_date", "in": "query", "required": true, "description": "Date of embryo transfer (YYYY-MM-DD).", "schema": { "type": "string" } }, { "name": "pregnancy_type", "in": "query", "required": false, "description": "Pregnancy type, such as singleton or multiple.", "schema": { "type": "string", "default": "single" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "due_date": { "type": "string", "format": "date" }, "transfer_date": { "type": "string", "format": "date" }, "transfer_type": { "type": "string" }, "pregnancy_type": { "type": "string" }, "gestational_age": { "type": "object", "properties": { "days": { "type": "integer" }, "weeks": { "type": "integer" } }, "additionalProperties": true } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Calculate Ivf Due Date", "description": "Estimates an IVF due date from embryo-transfer date and transfer type.", "operationId": "pregnancy-calculator_post_ivf-due-date", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "due_date": { "type": "string", "format": "date" }, "transfer_date": { "type": "string", "format": "date" }, "transfer_type": { "type": "string" }, "pregnancy_type": { "type": "string" }, "gestational_age": { "type": "object", "properties": { "days": { "type": "integer" }, "weeks": { "type": "integer" } }, "additionalProperties": true } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "transfer_type": { "type": "string", "enum": [ "Day-3 embryo transfer", "Day-5 embryo transfer", "IVF with own eggs", "IVF with donor eggs cycle" ] }, "transfer_date": { "type": "string" }, "pregnancy_type": { "type": "string", "default": "single" } }, "required": [ "transfer_date", "transfer_type" ], "example": { "transfer_date": "2026-10-01", "transfer_type": "Day-5 embryo transfer", "pregnancy_type": "single" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ivf/planner": { "get": { "summary": "Ivf Pregnancy Planner", "description": "Plans IVF transfer timing from desired due date and transfer type.", "operationId": "pregnancy-calculator_get_ivf_planner", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "transfer_type", "in": "query", "required": true, "description": "Embryo-transfer type used for IVF dating; required.", "schema": { "type": "string", "enum": [ "Day-3 embryo transfer", "Day-5 embryo transfer", "IVF with own eggs", "IVF with donor eggs cycle" ] } }, { "name": "desired_due_date", "in": "query", "required": false, "description": "Target due date (YYYY-MM-DD); provide this or transfer_schedule_date.", "schema": { "type": "string" }, "x-required-group": "ivf-target-date" }, { "name": "transfer_schedule_date", "in": "query", "required": false, "description": "Transfer date (YYYY-MM-DD); provide this or desired_due_date.", "schema": { "type": "string" }, "x-required-group": "ivf-target-date" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "mode": { "description": "Dynamic source value; no concrete response example is published." }, "status": { "type": "string" }, "transfer_type": { "description": "Dynamic source value; no concrete response example is published." }, "estimated_due_date": { "description": "Dynamic source value; no concrete response example is published." }, "transfer_schedule_date": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Ivf Pregnancy Planner", "description": "Plans IVF transfer timing from desired due date and transfer type.", "operationId": "pregnancy-calculator_post_ivf_planner", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "mode": { "description": "Dynamic source value; no concrete response example is published." }, "status": { "type": "string" }, "transfer_type": { "description": "Dynamic source value; no concrete response example is published." }, "estimated_due_date": { "description": "Dynamic source value; no concrete response example is published." }, "transfer_schedule_date": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "transfer_type": { "type": "string", "enum": [ "Day-3 embryo transfer", "Day-5 embryo transfer", "IVF with own eggs", "IVF with donor eggs cycle" ] }, "desired_due_date": { "type": "string", "x-required-group": "ivf-target-date" }, "transfer_schedule_date": { "type": "string", "x-required-group": "ivf-target-date" } }, "required": [ "transfer_type" ], "example": { "transfer_type": "Day-5 embryo transfer", "desired_due_date": "2027-02-01" } } } } }, "x-required-groups": { "ivf-target-date": [ "desired_due_date", "transfer_schedule_date" ] }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/ovulation": { "get": { "summary": "Calculate Ovulation", "description": "Estimates ovulation timing and the fertile window from the last period and cycle length.", "operationId": "pregnancy-calculator_get_ovulation", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "last_period_start", "in": "query", "required": true, "description": "First day of the last menstrual period (YYYY-MM-DD).", "schema": { "type": "string" } }, { "name": "cycle_length", "in": "query", "required": false, "description": "Typical menstrual-cycle length in days.", "schema": { "type": "integer", "default": 28 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "cycle_number": { "type": "integer" }, "ovulation_day": { "type": "string", "format": "date" }, "cycle_start_date": { "type": "string", "format": "date" }, "fertility_window": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true }, "due_date_if_conceived": { "type": "string", "format": "date" } }, "additionalProperties": true } }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Calculate Ovulation", "description": "Estimates ovulation timing and the fertile window from the last period and cycle length.", "operationId": "pregnancy-calculator_post_ovulation", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "cycle_number": { "type": "integer" }, "ovulation_day": { "type": "string", "format": "date" }, "cycle_start_date": { "type": "string", "format": "date" }, "fertility_window": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true }, "due_date_if_conceived": { "type": "string", "format": "date" } }, "additionalProperties": true } }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "last_period_start": { "type": "string" }, "cycle_length": { "type": "integer", "default": 28 } }, "required": [ "last_period_start" ], "example": { "cycle_length": 28, "last_period_start": "2026-01-01" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/pearl-index": { "get": { "summary": "Pearl Index Calculator", "description": "Calculates the Pearl Index from pregnancies, participants, and study duration.", "operationId": "pregnancy-calculator_get_pearl-index", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "num_women", "in": "query", "required": true, "description": "Number of participants exposed during the study.", "schema": { "type": "integer", "default": 0 } }, { "name": "study_duration_months", "in": "query", "required": true, "description": "Study duration in months.", "schema": { "type": "integer", "default": 0 } }, { "name": "num_pregnancies", "in": "query", "required": false, "description": "Number of pregnancies observed during the study.", "schema": { "type": "integer", "default": 0 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "summary": { "type": "string" }, "pearl_index": { "type": "number" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true, "x-dakidarts-sample-response": { "status": "success", "summary": "This method has a Pearl Index of 3.0, indicating it is less effective \u274c", "pearl_index": 3.0 } }, "post": { "summary": "Pearl Index Calculator", "description": "Calculates the Pearl Index from pregnancies, participants, and study duration.", "operationId": "pregnancy-calculator_post_pearl-index", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "summary": { "type": "string" }, "pearl_index": { "type": "number" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "num_women": { "type": "integer", "default": 0 }, "study_duration_months": { "type": "integer", "default": 0 }, "num_pregnancies": { "type": "integer", "default": 0 } }, "required": [ "num_women", "study_duration_months" ], "example": { "num_women": 100, "num_pregnancies": 3, "study_duration_months": 12 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true, "x-dakidarts-sample-response": { "status": "success", "summary": "This method has a Pearl Index of 3.0, indicating it is less effective \u274c", "pearl_index": 3.0 } } }, "/period": { "get": { "summary": "Calculate Period", "description": "Estimates period-cycle dates from the last period start and cycle length.", "operationId": "pregnancy-calculator_get_period", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "last_period_start", "in": "query", "required": true, "description": "First day of the last menstrual period (YYYY-MM-DD).", "schema": { "type": "string" } }, { "name": "cycle_length", "in": "query", "required": false, "description": "Typical menstrual-cycle length in days.", "schema": { "type": "integer", "default": 28 } }, { "name": "period_duration", "in": "query", "required": false, "description": "Typical period duration in days.", "schema": { "type": "integer", "default": 6 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "next_period": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true }, "fertile_window": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" }, "ovulation_day": { "type": "string", "format": "date" } }, "additionalProperties": true }, "future_periods": { "type": "array", "items": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true } } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Calculate Period", "description": "Estimates period-cycle dates from the last period start and cycle length.", "operationId": "pregnancy-calculator_post_period", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "next_period": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true }, "fertile_window": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" }, "ovulation_day": { "type": "string", "format": "date" } }, "additionalProperties": true }, "future_periods": { "type": "array", "items": { "type": "object", "properties": { "end": { "type": "string", "format": "date" }, "start": { "type": "string", "format": "date" } }, "additionalProperties": true } } }, "additionalProperties": true }, "status": { "type": "string" } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "last_period_start": { "type": "string" }, "cycle_length": { "type": "integer", "default": 28 }, "period_duration": { "type": "integer", "default": 6 } }, "required": [ "last_period_start" ], "example": { "cycle_length": 28, "period_duration": 6, "last_period_start": "2026-01-01" } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/reverse-due-date": { "get": { "summary": "Reverse Due Date", "description": "Estimates last menstrual period and conception dates from a due date.", "operationId": "pregnancy-calculator_get_reverse-due-date", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "due_date", "in": "query", "required": true, "description": "Estimated due date (YYYY-MM-DD).", "schema": { "type": "string" } }, { "name": "pregnancy_length_weeks", "in": "query", "required": false, "description": "Pregnancy length assumption in weeks.", "schema": { "type": "integer", "default": 40 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "conception_date": { "description": "Dynamic source value; no concrete response example is published." }, "intercourse_date": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Reverse Due Date", "description": "Estimates last menstrual period and conception dates from a due date.", "operationId": "pregnancy-calculator_post_reverse-due-date", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "conception_date": { "description": "Dynamic source value; no concrete response example is published." }, "intercourse_date": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "due_date": { "type": "string" }, "pregnancy_length_weeks": { "type": "integer", "default": 40 } }, "required": [ "due_date" ], "example": { "due_date": "2026-10-08", "pregnancy_length_weeks": 40 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } }, "/sperm-analysis": { "get": { "summary": "Sperm Analysis", "description": "Interprets semen-analysis measurements against reference ranges.", "operationId": "pregnancy-calculator_get_sperm-analysis", "tags": [ "Pregnancy calculations" ], "parameters": [ { "name": "ejaculate_volume", "in": "query", "required": true, "description": "Ejaculate volume in milliliters.", "schema": { "type": "number" } }, { "name": "sperm_concentration", "in": "query", "required": true, "description": "Sperm concentration in millions per milliliter.", "schema": { "type": "number" } }, { "name": "morphology", "in": "query", "required": true, "description": "Percentage of sperm with normal morphology.", "schema": { "type": "number" } }, { "name": "motility", "in": "query", "required": true, "description": "Percentage of motile sperm.", "schema": { "type": "number" } }, { "name": "vitality", "in": "query", "required": true, "description": "Percentage of live sperm.", "schema": { "type": "number" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "total_sperm": { "type": "integer" }, "functional_sperm": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true }, "post": { "summary": "Sperm Analysis", "description": "Interprets semen-analysis measurements against reference ranges.", "operationId": "pregnancy-calculator_post_sperm-analysis", "tags": [ "Pregnancy calculations" ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "total_sperm": { "type": "integer" }, "functional_sperm": { "description": "Dynamic source value; no concrete response example is published." } }, "additionalProperties": true } } } }, "4XX": { "description": "Client error" }, "5XX": { "description": "Upstream or gateway error" }, "503": { "description": "No live upstream is configured. Sample responses are preview-only." } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ejaculate_volume": { "type": "number" }, "sperm_concentration": { "type": "number" }, "morphology": { "type": "number" }, "motility": { "type": "number" }, "vitality": { "type": "number" } }, "required": [ "ejaculate_volume", "morphology", "motility", "sperm_concentration", "vitality" ], "example": { "motility": 50, "vitality": 60, "morphology": 4, "ejaculate_volume": 3, "sperm_concentration": 50 } } } } }, "x-dakidarts-execution-status": "source-only", "x-dakidarts-source-contract": true } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" } } }, "security": [ { "ApiKeyAuth": [] } ] }