APIAPI reference
Balance supplied species or explicitly request optional SynRBL
POST /v1/chemistry/balance
POST /v1/chemistry/balance
Authorization
This operation requires a bearer credential. The description defines additional role, scope or first-party-session restrictions; an API key does not grant those permissions by itself.
Request body
| Property | Type | Required | Details |
|---|---|---|---|
reaction_smiles | string | yes | |
method | "coefficients" ∣ "synrbl" | no | Default: "coefficients". |
Full schema: BalanceReactionRequest
{
"properties": {
"reaction_smiles": {
"type": "string",
"maxLength": 10000,
"minLength": 1,
"title": "Reaction Smiles"
},
"method": {
"type": "string",
"enum": [
"coefficients",
"synrbl"
],
"title": "Method",
"default": "coefficients"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"reaction_smiles"
],
"title": "BalanceReactionRequest"
}Responses
| HTTP | Details | Type |
|---|---|---|
| 200 | Successful Response | application/json: ReactionBalanceResult |
| 401 | Unauthorized | application/problem+json: ProblemDetails |
| 402 | Payment Required | application/problem+json: ProblemDetails |
| 403 | Forbidden | application/problem+json: ProblemDetails |
| 408 | Request Timeout | application/problem+json: ProblemDetails |
| 413 | Request Entity Too Large | application/problem+json: ProblemDetails |
| 422 | Unprocessable Entity | application/problem+json: ProblemDetails |
| 429 | Too Many Requests | application/problem+json: ProblemDetails |
| 502 | Bad Gateway | application/problem+json: ProblemDetails |
| 503 | Service Unavailable | application/problem+json: ProblemDetails |
Response: ReactionBalanceResult
| Property | Type | Required | Details |
|---|---|---|---|
method | "coefficients" ∣ "synrbl" | yes | |
status | "invalid" ∣ "already_balanced" ∣ "balanced" ∣ "unsolved" ∣ "ambiguous" ∣ "limit_exceeded" | yes | |
solved | boolean | yes | |
original_reaction_smiles | string | yes | |
balanced_reaction_smiles | string ∣ null | yes | |
reactant_coefficients | ReactionCoefficient[] | yes | |
product_coefficients | ReactionCoefficient[] | yes | |
imputed_species | boolean | yes | |
imputed_reactants | string ∣ null | no | |
imputed_products | string ∣ null | no | |
model_diagnostics | object ∣ null | no | |
validation | ReactionValidationResult | yes | |
limitations | string[] | yes |
Full schema
{
"properties": {
"method": {
"type": "string",
"enum": [
"coefficients",
"synrbl"
],
"title": "Method"
},
"status": {
"type": "string",
"enum": [
"invalid",
"already_balanced",
"balanced",
"unsolved",
"ambiguous",
"limit_exceeded"
],
"title": "Status"
},
"solved": {
"type": "boolean",
"title": "Solved"
},
"original_reaction_smiles": {
"type": "string",
"title": "Original Reaction Smiles"
},
"balanced_reaction_smiles": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Balanced Reaction Smiles"
},
"reactant_coefficients": {
"items": {
"$ref": "#/components/schemas/ReactionCoefficient"
},
"type": "array",
"title": "Reactant Coefficients"
},
"product_coefficients": {
"items": {
"$ref": "#/components/schemas/ReactionCoefficient"
},
"type": "array",
"title": "Product Coefficients"
},
"imputed_species": {
"type": "boolean",
"title": "Imputed Species"
},
"imputed_reactants": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Imputed Reactants"
},
"imputed_products": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Imputed Products"
},
"model_diagnostics": {
"anyOf": [
{
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"type": "object"
},
{
"type": "null"
}
],
"title": "Model Diagnostics"
},
"validation": {
"$ref": "#/components/schemas/ReactionValidationResult"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array",
"title": "Limitations"
}
},
"additionalProperties": true,
"type": "object",
"required": [
"method",
"status",
"solved",
"original_reaction_smiles",
"balanced_reaction_smiles",
"reactant_coefficients",
"product_coefficients",
"imputed_species",
"validation",
"limitations"
],
"title": "ReactionBalanceResult"
}This page is generated from OpenAPI; examples are schemas, not a fabricated successful response.