{
  "openapi": "3.1.1",
  "info": {
    "title": "Indexa API",
    "version": "1.0.0",
    "description": "Public Dominican locations, taxpayer lookup, exchange-rate data, and qualified fuel prices."
  },
  "servers": [
    {
      "url": "/"
    }
  ],
  "security": [],
  "paths": {
    "/v1/catalog": {
      "get": {
        "operationId": "getCatalog",
        "summary": "Get the active catalog release",
        "tags": [
          "catalog"
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "catalog"
                  ],
                  "properties": {
                    "catalog": {
                      "type": "object",
                      "required": [
                        "releaseId",
                        "effectiveOn",
                        "knownThrough",
                        "releaseSha256",
                        "scope",
                        "qualityStatus",
                        "publishedAt",
                        "status"
                      ],
                      "properties": {
                        "releaseId": {
                          "type": "string",
                          "pattern": "^dr_[A-Za-z0-9._-]+$"
                        },
                        "effectiveOn": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "knownThrough": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "releaseSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "scope": {
                          "type": "string"
                        },
                        "qualityStatus": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "verified"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "provisional"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "conflicted"
                              ]
                            }
                          ]
                        },
                        "publishedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "status": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "active"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "retained"
                              ]
                            }
                          ]
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/catalog/releases/{releaseId}": {
      "get": {
        "operationId": "getCatalogRelease",
        "summary": "Get a catalog release by key",
        "tags": [
          "catalog"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^dr_[A-Za-z0-9._-]+$"
            },
            "in": "path",
            "name": "releaseId",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "catalog"
                  ],
                  "properties": {
                    "catalog": {
                      "type": "object",
                      "required": [
                        "releaseId",
                        "effectiveOn",
                        "knownThrough",
                        "releaseSha256",
                        "scope",
                        "qualityStatus",
                        "publishedAt",
                        "status"
                      ],
                      "properties": {
                        "releaseId": {
                          "type": "string",
                          "pattern": "^dr_[A-Za-z0-9._-]+$"
                        },
                        "effectiveOn": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "knownThrough": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "releaseSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "scope": {
                          "type": "string"
                        },
                        "qualityStatus": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "verified"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "provisional"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "conflicted"
                              ]
                            }
                          ]
                        },
                        "publishedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "status": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "active"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "retained"
                              ]
                            }
                          ]
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/places/{placeId}": {
      "get": {
        "operationId": "getPlace",
        "summary": "Get a place and its current hierarchy",
        "tags": [
          "places"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^dr_[A-Za-z0-9._-]+$"
            },
            "in": "query",
            "name": "release",
            "required": false
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            },
            "in": "path",
            "name": "placeId",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "catalog",
                    "place"
                  ],
                  "properties": {
                    "catalog": {
                      "type": "object",
                      "required": [
                        "releaseId",
                        "effectiveOn",
                        "knownThrough",
                        "releaseSha256",
                        "scope",
                        "qualityStatus",
                        "publishedAt",
                        "status"
                      ],
                      "properties": {
                        "releaseId": {
                          "type": "string",
                          "pattern": "^dr_[A-Za-z0-9._-]+$"
                        },
                        "effectiveOn": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "knownThrough": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "releaseSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "scope": {
                          "type": "string"
                        },
                        "qualityStatus": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "verified"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "provisional"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "conflicted"
                              ]
                            }
                          ]
                        },
                        "publishedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "status": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "active"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "retained"
                              ]
                            }
                          ]
                        }
                      },
                      "additionalProperties": false
                    },
                    "place": {
                      "type": "object",
                      "required": [
                        "id",
                        "name",
                        "kind",
                        "qualityStatus",
                        "ancestors",
                        "identifiers",
                        "sources"
                      ],
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                        },
                        "name": {
                          "type": "string"
                        },
                        "kind": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "country"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "region"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "national_district"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "province"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "municipality"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "municipal_district"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "urban_zone"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "section"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "barrio"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "paraje"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "subbarrio"
                              ]
                            }
                          ]
                        },
                        "qualityStatus": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "verified"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "provisional"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "conflicted"
                              ]
                            }
                          ]
                        },
                        "ancestors": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "id",
                              "name",
                              "kind",
                              "qualityStatus"
                            ],
                            "properties": {
                              "id": {
                                "type": "string",
                                "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                              },
                              "name": {
                                "type": "string"
                              },
                              "kind": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "enum": [
                                      "country"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "region"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "national_district"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "province"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "municipality"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "municipal_district"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "urban_zone"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "section"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "barrio"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "paraje"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "subbarrio"
                                    ]
                                  }
                                ]
                              },
                              "qualityStatus": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "enum": [
                                      "verified"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "provisional"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "conflicted"
                                    ]
                                  }
                                ]
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "identifiers": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "scheme",
                              "code"
                            ],
                            "properties": {
                              "scheme": {
                                "type": "string"
                              },
                              "code": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "sources": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "namespace",
                              "artifactSha256"
                            ],
                            "properties": {
                              "namespace": {
                                "type": "string"
                              },
                              "artifactSha256": {
                                "type": "string",
                                "pattern": "^[0-9a-f]{64}$"
                              }
                            },
                            "additionalProperties": false
                          }
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/places/{placeId}/children": {
      "get": {
        "operationId": "listPlaceChildren",
        "summary": "List direct children of a place",
        "tags": [
          "places"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^dr_[A-Za-z0-9._-]+$"
            },
            "in": "query",
            "name": "release",
            "required": false
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "country"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "region"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "national_district"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "province"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "municipality"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "municipal_district"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "urban_zone"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "section"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "barrio"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "paraje"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "subbarrio"
                  ]
                }
              ]
            },
            "in": "query",
            "name": "kind",
            "required": false
          },
          {
            "schema": {
              "type": "string",
              "pattern": "\\S"
            },
            "in": "query",
            "name": "requiredScheme",
            "required": false
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "in": "query",
            "name": "limit",
            "required": false
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "in": "query",
            "name": "cursor",
            "required": false
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            },
            "in": "path",
            "name": "placeId",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "catalog",
                    "children",
                    "nextCursor"
                  ],
                  "properties": {
                    "catalog": {
                      "type": "object",
                      "required": [
                        "releaseId",
                        "effectiveOn",
                        "knownThrough",
                        "releaseSha256",
                        "scope",
                        "qualityStatus",
                        "publishedAt",
                        "status"
                      ],
                      "properties": {
                        "releaseId": {
                          "type": "string",
                          "pattern": "^dr_[A-Za-z0-9._-]+$"
                        },
                        "effectiveOn": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "knownThrough": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "releaseSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "scope": {
                          "type": "string"
                        },
                        "qualityStatus": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "verified"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "provisional"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "conflicted"
                              ]
                            }
                          ]
                        },
                        "publishedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "status": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "active"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "retained"
                              ]
                            }
                          ]
                        }
                      },
                      "additionalProperties": false
                    },
                    "children": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "name",
                          "kind",
                          "qualityStatus",
                          "ancestors",
                          "identifiers",
                          "sources"
                        ],
                        "properties": {
                          "id": {
                            "type": "string",
                            "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                          },
                          "name": {
                            "type": "string"
                          },
                          "kind": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "country"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "region"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "national_district"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "province"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "municipality"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "municipal_district"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "urban_zone"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "section"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "barrio"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "paraje"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "subbarrio"
                                ]
                              }
                            ]
                          },
                          "qualityStatus": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "verified"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "provisional"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "conflicted"
                                ]
                              }
                            ]
                          },
                          "ancestors": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "id",
                                "name",
                                "kind",
                                "qualityStatus"
                              ],
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                                },
                                "name": {
                                  "type": "string"
                                },
                                "kind": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "country"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "region"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "national_district"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "province"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "municipality"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "municipal_district"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "urban_zone"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "section"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "barrio"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "paraje"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "subbarrio"
                                      ]
                                    }
                                  ]
                                },
                                "qualityStatus": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "verified"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "provisional"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "conflicted"
                                      ]
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "identifiers": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "scheme",
                                "code"
                              ],
                              "properties": {
                                "scheme": {
                                  "type": "string"
                                },
                                "code": {
                                  "type": "string"
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "sources": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "namespace",
                                "artifactSha256"
                              ],
                              "properties": {
                                "namespace": {
                                  "type": "string"
                                },
                                "artifactSha256": {
                                  "type": "string",
                                  "pattern": "^[0-9a-f]{64}$"
                                }
                              },
                              "additionalProperties": false
                            }
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/places/search": {
      "get": {
        "operationId": "searchPlaces",
        "summary": "Search place names",
        "tags": [
          "places"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "\\S"
            },
            "in": "query",
            "name": "q",
            "required": true
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "country"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "region"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "national_district"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "province"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "municipality"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "municipal_district"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "urban_zone"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "section"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "barrio"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "paraje"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "subbarrio"
                  ]
                }
              ]
            },
            "in": "query",
            "name": "kind",
            "required": false
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            },
            "in": "query",
            "name": "within",
            "required": false
          },
          {
            "schema": {
              "type": "string",
              "pattern": "\\S"
            },
            "in": "query",
            "name": "requiredScheme",
            "required": false
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^dr_[A-Za-z0-9._-]+$"
            },
            "in": "query",
            "name": "release",
            "required": false
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "in": "query",
            "name": "limit",
            "required": false
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "in": "query",
            "name": "cursor",
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "catalog",
                    "places",
                    "nextCursor"
                  ],
                  "properties": {
                    "catalog": {
                      "type": "object",
                      "required": [
                        "releaseId",
                        "effectiveOn",
                        "knownThrough",
                        "releaseSha256",
                        "scope",
                        "qualityStatus",
                        "publishedAt",
                        "status"
                      ],
                      "properties": {
                        "releaseId": {
                          "type": "string",
                          "pattern": "^dr_[A-Za-z0-9._-]+$"
                        },
                        "effectiveOn": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "knownThrough": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "releaseSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "scope": {
                          "type": "string"
                        },
                        "qualityStatus": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "verified"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "provisional"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "conflicted"
                              ]
                            }
                          ]
                        },
                        "publishedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "status": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "active"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "retained"
                              ]
                            }
                          ]
                        }
                      },
                      "additionalProperties": false
                    },
                    "places": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "name",
                          "kind",
                          "qualityStatus",
                          "ancestors",
                          "identifiers",
                          "sources",
                          "matchedName",
                          "matchKind"
                        ],
                        "properties": {
                          "id": {
                            "type": "string",
                            "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                          },
                          "name": {
                            "type": "string"
                          },
                          "kind": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "country"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "region"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "national_district"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "province"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "municipality"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "municipal_district"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "urban_zone"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "section"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "barrio"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "paraje"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "subbarrio"
                                ]
                              }
                            ]
                          },
                          "qualityStatus": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "verified"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "provisional"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "conflicted"
                                ]
                              }
                            ]
                          },
                          "ancestors": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "id",
                                "name",
                                "kind",
                                "qualityStatus"
                              ],
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                                },
                                "name": {
                                  "type": "string"
                                },
                                "kind": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "country"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "region"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "national_district"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "province"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "municipality"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "municipal_district"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "urban_zone"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "section"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "barrio"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "paraje"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "subbarrio"
                                      ]
                                    }
                                  ]
                                },
                                "qualityStatus": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "verified"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "provisional"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "conflicted"
                                      ]
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "identifiers": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "scheme",
                                "code"
                              ],
                              "properties": {
                                "scheme": {
                                  "type": "string"
                                },
                                "code": {
                                  "type": "string"
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "sources": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "namespace",
                                "artifactSha256"
                              ],
                              "properties": {
                                "namespace": {
                                  "type": "string"
                                },
                                "artifactSha256": {
                                  "type": "string",
                                  "pattern": "^[0-9a-f]{64}$"
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "matchedName": {
                            "type": "string"
                          },
                          "matchKind": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "exact"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "prefix"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "fuzzy"
                                ]
                              }
                            ]
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/places/resolve": {
      "get": {
        "operationId": "resolvePlaceIdentifier",
        "summary": "Resolve an exact scheme and code",
        "tags": [
          "places"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "\\S"
            },
            "in": "query",
            "name": "scheme",
            "required": true
          },
          {
            "schema": {
              "type": "string",
              "pattern": "\\S"
            },
            "in": "query",
            "name": "code",
            "required": true
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^dr_[A-Za-z0-9._-]+$"
            },
            "in": "query",
            "name": "release",
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "catalog",
                    "matches"
                  ],
                  "properties": {
                    "catalog": {
                      "type": "object",
                      "required": [
                        "releaseId",
                        "effectiveOn",
                        "knownThrough",
                        "releaseSha256",
                        "scope",
                        "qualityStatus",
                        "publishedAt",
                        "status"
                      ],
                      "properties": {
                        "releaseId": {
                          "type": "string",
                          "pattern": "^dr_[A-Za-z0-9._-]+$"
                        },
                        "effectiveOn": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "knownThrough": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "releaseSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "scope": {
                          "type": "string"
                        },
                        "qualityStatus": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "verified"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "provisional"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "conflicted"
                              ]
                            }
                          ]
                        },
                        "publishedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "status": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "active"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "retained"
                              ]
                            }
                          ]
                        }
                      },
                      "additionalProperties": false
                    },
                    "matches": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "name",
                          "kind",
                          "qualityStatus",
                          "ancestors",
                          "identifiers",
                          "sources"
                        ],
                        "properties": {
                          "id": {
                            "type": "string",
                            "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                          },
                          "name": {
                            "type": "string"
                          },
                          "kind": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "country"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "region"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "national_district"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "province"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "municipality"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "municipal_district"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "urban_zone"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "section"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "barrio"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "paraje"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "subbarrio"
                                ]
                              }
                            ]
                          },
                          "qualityStatus": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "verified"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "provisional"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "conflicted"
                                ]
                              }
                            ]
                          },
                          "ancestors": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "id",
                                "name",
                                "kind",
                                "qualityStatus"
                              ],
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                                },
                                "name": {
                                  "type": "string"
                                },
                                "kind": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "country"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "region"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "national_district"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "province"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "municipality"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "municipal_district"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "urban_zone"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "section"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "barrio"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "paraje"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "subbarrio"
                                      ]
                                    }
                                  ]
                                },
                                "qualityStatus": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "verified"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "provisional"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "conflicted"
                                      ]
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "identifiers": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "scheme",
                                "code"
                              ],
                              "properties": {
                                "scheme": {
                                  "type": "string"
                                },
                                "code": {
                                  "type": "string"
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "sources": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "namespace",
                                "artifactSha256"
                              ],
                              "properties": {
                                "namespace": {
                                  "type": "string"
                                },
                                "artifactSha256": {
                                  "type": "string",
                                  "pattern": "^[0-9a-f]{64}$"
                                }
                              },
                              "additionalProperties": false
                            }
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/places/{placeId}/provenance": {
      "get": {
        "operationId": "getPlaceProvenance",
        "summary": "Get source assertions and conflicts for a place",
        "tags": [
          "provenance"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^dr_[A-Za-z0-9._-]+$"
            },
            "in": "query",
            "name": "release",
            "required": false
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
            },
            "in": "path",
            "name": "placeId",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "catalog",
                    "provenance"
                  ],
                  "properties": {
                    "catalog": {
                      "type": "object",
                      "required": [
                        "releaseId",
                        "effectiveOn",
                        "knownThrough",
                        "releaseSha256",
                        "scope",
                        "qualityStatus",
                        "publishedAt",
                        "status"
                      ],
                      "properties": {
                        "releaseId": {
                          "type": "string",
                          "pattern": "^dr_[A-Za-z0-9._-]+$"
                        },
                        "effectiveOn": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "knownThrough": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "releaseSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "scope": {
                          "type": "string"
                        },
                        "qualityStatus": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "verified"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "provisional"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "conflicted"
                              ]
                            }
                          ]
                        },
                        "publishedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "status": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "active"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "retained"
                              ]
                            }
                          ]
                        }
                      },
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "placeId",
                        "releaseId",
                        "assertions",
                        "conflicts"
                      ],
                      "properties": {
                        "placeId": {
                          "type": "string",
                          "pattern": "^place_[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
                        },
                        "releaseId": {
                          "type": "string",
                          "pattern": "^dr_[A-Za-z0-9._-]+$"
                        },
                        "assertions": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "namespace",
                              "sourceUri",
                              "acquisitionUrl",
                              "finalUrl",
                              "observedHttpStatus",
                              "acquisitionAttempts",
                              "artifactSha256",
                              "sourceDate",
                              "effectiveFrom",
                              "knownThrough",
                              "publishedAt",
                              "retrievedAt",
                              "parserVersion",
                              "rightsStatus",
                              "recordKey",
                              "name",
                              "code",
                              "kind",
                              "parentKey",
                              "matchMethod",
                              "confidence",
                              "decision",
                              "rationale"
                            ],
                            "properties": {
                              "namespace": {
                                "type": "string"
                              },
                              "sourceUri": {
                                "type": "string"
                              },
                              "acquisitionUrl": {
                                "type": "string"
                              },
                              "finalUrl": {
                                "type": "string"
                              },
                              "observedHttpStatus": {
                                "type": "integer",
                                "minimum": 200,
                                "maximum": 299
                              },
                              "acquisitionAttempts": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "required": [
                                    "url",
                                    "outcome",
                                    "observedHttpStatus",
                                    "finalUrl",
                                    "failure"
                                  ],
                                  "properties": {
                                    "url": {
                                      "type": "string"
                                    },
                                    "outcome": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "enum": [
                                            "failed"
                                          ]
                                        },
                                        {
                                          "type": "string",
                                          "enum": [
                                            "fetched"
                                          ]
                                        }
                                      ]
                                    },
                                    "observedHttpStatus": {
                                      "anyOf": [
                                        {
                                          "type": "integer",
                                          "minimum": 100,
                                          "maximum": 599
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "finalUrl": {
                                      "anyOf": [
                                        {
                                          "type": "string"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "failure": {
                                      "anyOf": [
                                        {
                                          "type": "string"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "additionalProperties": false
                                },
                                "minItems": 1
                              },
                              "artifactSha256": {
                                "type": "string",
                                "pattern": "^[0-9a-f]{64}$"
                              },
                              "sourceDate": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "effectiveFrom": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "knownThrough": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "publishedAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "retrievedAt": {
                                "type": "string",
                                "format": "date-time"
                              },
                              "parserVersion": {
                                "type": "string"
                              },
                              "rightsStatus": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "enum": [
                                      "unresolved"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "permitted"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "scope_limited"
                                    ]
                                  },
                                  {
                                    "type": "string",
                                    "enum": [
                                      "restricted"
                                    ]
                                  }
                                ]
                              },
                              "recordKey": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "code": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "kind": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "parentKey": {
                                "anyOf": [
                                  {
                                    "type": "string"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "matchMethod": {
                                "type": "string"
                              },
                              "confidence": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 1
                              },
                              "decision": {
                                "type": "string"
                              },
                              "rationale": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "conflicts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "conflictKey",
                              "summary"
                            ],
                            "properties": {
                              "conflictKey": {
                                "type": "string"
                              },
                              "summary": {
                                "type": "string"
                              }
                            },
                            "additionalProperties": false
                          }
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "type",
                        "code",
                        "message",
                        "param",
                        "docUrl",
                        "requestId"
                      ],
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "code": {
                          "type": "string"
                        },
                        "message": {
                          "type": "string"
                        },
                        "param": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "docUrl": {
                          "type": "string",
                          "format": "uri-reference"
                        },
                        "requestId": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/taxpayers/search": {
      "get": {
        "operationId": "searchTaxpayers",
        "summary": "Find taxpayers by name, RNC, or cédula",
        "tags": [
          "Taxpayers"
        ],
        "description": "One query finds taxpayers. A value that is 9 or 11 digits, ignoring spaces and hyphens, is an RNC or cédula and returns that taxpayer or an empty list from the current publication, last-known directory rows, and saved web discoveries. It does not call the DGII web form; GET /v1/taxpayers/{taxId} does. Any other value searches aggregated registered and commercial names in the current publication and saved web discoveries without case or accent sensitivity. limit applies only to names. No matches does not establish non-registration.",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048
            },
            "in": "query",
            "name": "q",
            "required": true,
            "description": "A name, a 9-digit RNC, or an 11-digit cédula. Spaces and hyphens are ignored for identifiers. Names use 3–120 normalized characters, including three consecutive letters or digits."
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 20
            },
            "in": "query",
            "name": "limit",
            "required": false,
            "description": "Maximum name matches. Ignored when q is an RNC or cédula."
          }
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "taxpayers"
                  ],
                  "properties": {
                    "taxpayers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "taxId",
                          "registeredName",
                          "commercialName"
                        ],
                        "properties": {
                          "taxId": {
                            "type": "string",
                            "pattern": "^(?:[0-9]{9}|[0-9]{11})$"
                          },
                          "registeredName": {
                            "type": "string",
                            "minLength": 1
                          },
                          "commercialName": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "search_invalid"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "search_unavailable"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/taxpayers/{taxId}": {
      "get": {
        "operationId": "getTaxpayer",
        "summary": "Look up a taxpayer",
        "tags": [
          "Taxpayers"
        ],
        "description": "Returns taxpayer identity and available DGII facts: category, electronic-invoicer status, economic activity, operations start date, payment regime, DGII status, and classification in DGII’s local and medium taxpayer electronic-invoicing implementation list. Classification null means unavailable or not listed; it does not establish whether the taxpayer is large. Classification is separate from category and MICM certification. Fields are aggregated by exact identifier from the directory and saved DGII web observations. Missing source values and failed refreshes do not erase available facts. Other unavailable facts are null.",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^(?:[0-9]{9}|[0-9]{11})$"
            },
            "in": "path",
            "name": "taxId",
            "required": true
          }
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "taxpayer"
                  ],
                  "properties": {
                    "taxpayer": {
                      "type": "object",
                      "required": [
                        "taxId",
                        "kind",
                        "registeredName",
                        "commercialName",
                        "registrationStatus",
                        "checksumStatus",
                        "category",
                        "isElectronicInvoicer",
                        "economicActivity",
                        "operationsStartedOn",
                        "paymentRegime",
                        "dgiiStatus",
                        "classification"
                      ],
                      "properties": {
                        "taxId": {
                          "type": "string",
                          "pattern": "^(?:[0-9]{9}|[0-9]{11})$"
                        },
                        "kind": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "rnc"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "cedula"
                              ]
                            }
                          ]
                        },
                        "registeredName": {
                          "type": "string",
                          "minLength": 1
                        },
                        "commercialName": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "registrationStatus": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "active"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "inactive"
                              ]
                            }
                          ]
                        },
                        "checksumStatus": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "checksum_valid"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "issued_exception"
                              ]
                            }
                          ]
                        },
                        "category": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "DGII category as published; not a legal form or company-size classification."
                        },
                        "isElectronicInvoicer": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "DGII electronic-invoicer flag. Null means unknown, not false."
                        },
                        "economicActivity": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "operationsStartedOn": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "paymentRegime": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "dgiiStatus": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "classification": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Classification in DGII’s local and medium taxpayer electronic-invoicing implementation list. Null means unavailable or not listed; it does not establish whether the taxpayer is large. Separate from category and MICM certification."
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "tax_id_invalid"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "taxpayer_not_found"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "type": "object",
                      "required": [
                        "error"
                      ],
                      "properties": {
                        "error": {
                          "type": "object",
                          "required": [
                            "code",
                            "message",
                            "requestId"
                          ],
                          "properties": {
                            "code": {
                              "type": "string",
                              "enum": [
                                "directory_not_ready"
                              ]
                            },
                            "message": {
                              "type": "string",
                              "minLength": 1
                            },
                            "requestId": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "required": [
                        "error"
                      ],
                      "properties": {
                        "error": {
                          "type": "object",
                          "required": [
                            "code",
                            "message",
                            "requestId"
                          ],
                          "properties": {
                            "code": {
                              "type": "string",
                              "enum": [
                                "authority_lookup_unavailable"
                              ]
                            },
                            "message": {
                              "type": "string",
                              "minLength": 1
                            },
                            "requestId": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "additionalProperties": false
                        }
                      },
                      "additionalProperties": false
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/exchange-rate-providers": {
      "get": {
        "operationId": "listExchangeRateProviders",
        "summary": "List exchange-rate providers",
        "tags": [
          "Exchange rates"
        ],
        "description": "List providers and qualified source coverage.",
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "providers"
                  ],
                  "properties": {
                    "providers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "name",
                          "supportedSeries",
                          "sources"
                        ],
                        "properties": {
                          "id": {
                            "type": "string",
                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1
                          },
                          "supportedSeries": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "baseCurrency",
                                "quoteCurrency",
                                "channel"
                              ],
                              "properties": {
                                "baseCurrency": {
                                  "type": "string",
                                  "pattern": "^[A-Z]{3}$"
                                },
                                "quoteCurrency": {
                                  "type": "string",
                                  "pattern": "^[A-Z]{3}$"
                                },
                                "channel": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "office"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "online"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "unspecified"
                                      ]
                                    }
                                  ]
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "sources": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "id",
                                "name",
                                "kind",
                                "currentAvailable",
                                "historicalAvailable"
                              ],
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                                },
                                "name": {
                                  "type": "string",
                                  "minLength": 1
                                },
                                "kind": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "direct"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "secondary"
                                      ]
                                    },
                                    {
                                      "type": "string",
                                      "enum": [
                                        "legacy"
                                      ]
                                    }
                                  ]
                                },
                                "currentAvailable": {
                                  "type": "boolean"
                                },
                                "historicalAvailable": {
                                  "type": "boolean"
                                }
                              },
                              "additionalProperties": false
                            }
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/exchange-rates": {
      "get": {
        "operationId": "getLatestExchangeRates",
        "summary": "Get latest exchange rates",
        "tags": [
          "Exchange rates"
        ],
        "description": "Return fresh qualified quotes. Secondary sources are considered only with allowSecondary=true.",
        "parameters": [
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "provider",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "base",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "quote",
            "required": false
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "office"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "online"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "unspecified"
                  ]
                }
              ]
            },
            "in": "query",
            "name": "channel",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "allowSecondary",
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "rates",
                    "unavailable"
                  ],
                  "properties": {
                    "rates": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "provider",
                          "baseCurrency",
                          "quoteCurrency",
                          "channel",
                          "buy",
                          "sell",
                          "source",
                          "sourceKind",
                          "observationDate",
                          "observedAt",
                          "retrievedAt"
                        ],
                        "properties": {
                          "provider": {
                            "type": "string",
                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                          },
                          "baseCurrency": {
                            "type": "string",
                            "pattern": "^[A-Z]{3}$"
                          },
                          "quoteCurrency": {
                            "type": "string",
                            "pattern": "^[A-Z]{3}$"
                          },
                          "channel": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "office"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "online"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "unspecified"
                                ]
                              }
                            ]
                          },
                          "buy": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9]+(?:\\.[0-9]+)?$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "sell": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9]+(?:\\.[0-9]+)?$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "source": {
                            "type": "string",
                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                          },
                          "sourceKind": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "direct"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "secondary"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "legacy"
                                ]
                              }
                            ]
                          },
                          "observationDate": {
                            "type": "string",
                            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                          },
                          "observedAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "retrievedAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "unavailable": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "provider",
                          "baseCurrency",
                          "quoteCurrency",
                          "channel",
                          "reason"
                        ],
                        "properties": {
                          "provider": {
                            "type": "string",
                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                          },
                          "baseCurrency": {
                            "type": "string",
                            "pattern": "^[A-Z]{3}$"
                          },
                          "quoteCurrency": {
                            "type": "string",
                            "pattern": "^[A-Z]{3}$"
                          },
                          "channel": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "office"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "online"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "unspecified"
                                ]
                              }
                            ]
                          },
                          "reason": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "stale"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "unavailable"
                                ]
                              }
                            ]
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/exchange-rates/history": {
      "get": {
        "operationId": "getExchangeRateHistory",
        "summary": "Get exchange-rate history",
        "tags": [
          "Exchange rates"
        ],
        "description": "Return captured qualified changes. Empty intervals do not prove that a provider's prices were unchanged.",
        "parameters": [
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "provider",
            "required": true
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "base",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "quote",
            "required": false
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "office"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "online"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "unspecified"
                  ]
                }
              ]
            },
            "in": "query",
            "name": "channel",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "source",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "from",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "to",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "limit",
            "required": false
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]+$"
            },
            "in": "query",
            "name": "cursor",
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "observations",
                    "nextCursor"
                  ],
                  "properties": {
                    "observations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "provider",
                          "baseCurrency",
                          "quoteCurrency",
                          "channel",
                          "buy",
                          "sell",
                          "source",
                          "sourceKind",
                          "observationDate",
                          "observedAt",
                          "retrievedAt"
                        ],
                        "properties": {
                          "provider": {
                            "type": "string",
                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                          },
                          "baseCurrency": {
                            "type": "string",
                            "pattern": "^[A-Z]{3}$"
                          },
                          "quoteCurrency": {
                            "type": "string",
                            "pattern": "^[A-Z]{3}$"
                          },
                          "channel": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "office"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "online"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "unspecified"
                                ]
                              }
                            ]
                          },
                          "buy": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9]+(?:\\.[0-9]+)?$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "sell": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9]+(?:\\.[0-9]+)?$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "source": {
                            "type": "string",
                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                          },
                          "sourceKind": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "direct"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "secondary"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "legacy"
                                ]
                              }
                            ]
                          },
                          "observationDate": {
                            "type": "string",
                            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                          },
                          "observedAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "retrievedAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        },
                        "additionalProperties": false
                      }
                    },
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9_-]+$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/fuels": {
      "get": {
        "operationId": "listFuels",
        "summary": "List fuel products",
        "tags": [
          "Fuel prices"
        ],
        "description": "List stable Dominican fuel products and qualified price availability.",
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "fuels"
                  ],
                  "properties": {
                    "fuels": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "id",
                          "name",
                          "lifecycle",
                          "observedFrom",
                          "observedThrough",
                          "currentAvailable",
                          "historicalAvailable",
                          "units"
                        ],
                        "properties": {
                          "id": {
                            "type": "string",
                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1
                          },
                          "lifecycle": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "current"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "historical-only"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "unresolved"
                                ]
                              }
                            ]
                          },
                          "observedFrom": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "observedThrough": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "currentAvailable": {
                            "type": "boolean"
                          },
                          "historicalAvailable": {
                            "type": "boolean"
                          },
                          "units": {
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "CUBIC_METER"
                                  ]
                                },
                                {
                                  "type": "string",
                                  "enum": [
                                    "MMBTU"
                                  ]
                                },
                                {
                                  "type": "string",
                                  "enum": [
                                    "METRIC_TON"
                                  ]
                                },
                                {
                                  "type": "string",
                                  "enum": [
                                    "US_GALLON"
                                  ]
                                }
                              ]
                            },
                            "uniqueItems": true
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/fuels/{fuel}": {
      "get": {
        "operationId": "getFuel",
        "summary": "Get a fuel product",
        "tags": [
          "Fuel prices"
        ],
        "description": "Get one fuel product and its qualified external classifications.",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
            },
            "in": "path",
            "name": "fuel",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "id",
                    "name",
                    "lifecycle",
                    "observedFrom",
                    "observedThrough",
                    "currentAvailable",
                    "historicalAvailable",
                    "units",
                    "classifications"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                    },
                    "name": {
                      "type": "string",
                      "minLength": 1
                    },
                    "lifecycle": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "current"
                          ]
                        },
                        {
                          "type": "string",
                          "enum": [
                            "historical-only"
                          ]
                        },
                        {
                          "type": "string",
                          "enum": [
                            "unresolved"
                          ]
                        }
                      ]
                    },
                    "observedFrom": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "observedThrough": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "currentAvailable": {
                      "type": "boolean"
                    },
                    "historicalAvailable": {
                      "type": "boolean"
                    },
                    "units": {
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "CUBIC_METER"
                            ]
                          },
                          {
                            "type": "string",
                            "enum": [
                              "MMBTU"
                            ]
                          },
                          {
                            "type": "string",
                            "enum": [
                              "METRIC_TON"
                            ]
                          },
                          {
                            "type": "string",
                            "enum": [
                              "US_GALLON"
                            ]
                          }
                        ]
                      },
                      "uniqueItems": true
                    },
                    "classifications": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "scheme",
                          "version",
                          "code",
                          "relation",
                          "status",
                          "validFrom",
                          "validTo",
                          "sourceUrl"
                        ],
                        "properties": {
                          "scheme": {
                            "type": "string",
                            "minLength": 1
                          },
                          "version": {
                            "type": "string",
                            "minLength": 1
                          },
                          "code": {
                            "type": "string",
                            "minLength": 1
                          },
                          "relation": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "exact"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "broader"
                                ]
                              }
                            ]
                          },
                          "status": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "confirmed"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "broader-only"
                                ]
                              }
                            ]
                          },
                          "validFrom": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "validTo": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "sourceUrl": {
                            "type": "string",
                            "format": "uri"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/fuel-prices": {
      "get": {
        "operationId": "getFuelPrices",
        "summary": "Get applicable fuel prices",
        "tags": [
          "Fuel prices"
        ],
        "description": "Return qualified official public-consumer prices applicable on a Dominican calendar date.",
        "parameters": [
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "deliveryMode",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "effectiveOn",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "fuel",
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "effectiveOn",
                    "prices"
                  ],
                  "properties": {
                    "effectiveOn": {
                      "type": "string",
                      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                    },
                    "prices": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "fuel",
                          "name",
                          "amount",
                          "currency",
                          "unit",
                          "priceContext",
                          "saleStage",
                          "effectiveFrom",
                          "effectiveTo",
                          "publishedAt",
                          "resolutionNumber",
                          "sourceUrl"
                        ],
                        "properties": {
                          "fuel": {
                            "type": "string",
                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1
                          },
                          "amount": {
                            "type": "string",
                            "pattern": "^[0-9]+(?:\\.[0-9]+)?$"
                          },
                          "currency": {
                            "type": "string",
                            "enum": [
                              "DOP"
                            ]
                          },
                          "unit": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "CUBIC_METER"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "MMBTU"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "METRIC_TON"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "US_GALLON"
                                ]
                              }
                            ]
                          },
                          "priceContext": {
                            "type": "string",
                            "enum": [
                              "public-consumer"
                            ]
                          },
                          "saleStage": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "filling-plant-to-public"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "retail"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "station-to-public"
                                ]
                              }
                            ]
                          },
                          "deliveryMode": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "cng"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "lng"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "traditional-pipeline"
                                ]
                              }
                            ]
                          },
                          "effectiveFrom": {
                            "type": "string",
                            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                          },
                          "effectiveTo": {
                            "type": "string",
                            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                          },
                          "publishedAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "resolutionNumber": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "sourceUrl": {
                            "type": "string",
                            "format": "uri"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    },
    "/v1/fuel-prices/history": {
      "get": {
        "operationId": "getFuelPriceHistory",
        "summary": "Get fuel-price history",
        "tags": [
          "Fuel prices"
        ],
        "description": "Return qualified schedules whose inclusive effective intervals overlap the requested dates.",
        "parameters": [
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "cursor",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "deliveryMode",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "from",
            "required": true
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "fuel",
            "required": true
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "limit",
            "required": false
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "to",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "nextCursor",
                    "prices"
                  ],
                  "properties": {
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9_-]+$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "prices": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "fuel",
                          "name",
                          "amount",
                          "currency",
                          "unit",
                          "priceContext",
                          "saleStage",
                          "effectiveFrom",
                          "effectiveTo",
                          "publishedAt",
                          "resolutionNumber",
                          "sourceUrl"
                        ],
                        "properties": {
                          "fuel": {
                            "type": "string",
                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1
                          },
                          "amount": {
                            "type": "string",
                            "pattern": "^[0-9]+(?:\\.[0-9]+)?$"
                          },
                          "currency": {
                            "type": "string",
                            "enum": [
                              "DOP"
                            ]
                          },
                          "unit": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "CUBIC_METER"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "MMBTU"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "METRIC_TON"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "US_GALLON"
                                ]
                              }
                            ]
                          },
                          "priceContext": {
                            "type": "string",
                            "enum": [
                              "public-consumer"
                            ]
                          },
                          "saleStage": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "filling-plant-to-public"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "retail"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "station-to-public"
                                ]
                              }
                            ]
                          },
                          "deliveryMode": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "cng"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "lng"
                                ]
                              },
                              {
                                "type": "string",
                                "enum": [
                                  "traditional-pipeline"
                                ]
                              }
                            ]
                          },
                          "effectiveFrom": {
                            "type": "string",
                            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                          },
                          "effectiveTo": {
                            "type": "string",
                            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
                          },
                          "publishedAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "resolutionNumber": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "sourceUrl": {
                            "type": "string",
                            "format": "uri"
                          }
                        },
                        "additionalProperties": false
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "404": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "503": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "requestId",
                        "retryable"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "minLength": 1
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1
                        },
                        "requestId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "retryable": {
                          "type": "boolean"
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {}
  }
}