{
  "openapi": "3.1.1",
  "info": {
    "title": "API de Indexa",
    "version": "1.0.0",
    "description": "Consulta pública de localidades y contribuyentes dominicanos, datos de tasas de cambio y precios calificados de combustibles."
  },
  "servers": [
    {
      "url": "/"
    }
  ],
  "security": [],
  "paths": {
    "/v1/catalog": {
      "get": {
        "operationId": "getCatalog",
        "summary": "Obtén la versión activa del catálogo",
        "tags": [
          "catalog"
        ],
        "responses": {
          "200": {
            "description": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Obtén una versión del catálogo por su clave",
        "tags": [
          "catalog"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^dr_[A-Za-z0-9._-]+$"
            },
            "in": "path",
            "name": "releaseId",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Obtén un lugar y su jerarquía actual",
        "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Lista los descendientes directos de un lugar",
        "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Busca nombres de localidades",
        "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Resuelve un esquema y código exactos",
        "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Obtén las afirmaciones y los conflictos de las fuentes de un lugar",
        "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Buscar contribuyentes por nombre, RNC o cédula",
        "tags": [
          "Taxpayers"
        ],
        "description": "Una sola consulta busca contribuyentes. Un valor de 9 u 11 dígitos, sin contar espacios ni guiones, se interpreta como RNC o cédula y devuelve ese contribuyente o una lista vacía a partir de la publicación actual y las últimas observaciones conocidas. No consulta el formulario web de la DGII; GET /v1/taxpayers/{taxId} sí puede hacerlo. Los demás valores buscan nombres registrados y comerciales sin distinguir mayúsculas ni acentos. limit se aplica solo a nombres. No encontrar coincidencias no demuestra ausencia de registro. La búsqueda también incluye los contribuyentes descubiertos mediante consultas web y guardados, con sus nombres combinados con el directorio.",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048
            },
            "in": "query",
            "name": "q",
            "required": true,
            "description": "Un nombre, un RNC de 9 dígitos o una cédula de 11 dígitos. Se ignoran los espacios y guiones en los identificadores. Los nombres usan entre 3 y 120 caracteres normalizados, con al menos tres letras o números consecutivos."
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 20
            },
            "in": "query",
            "name": "limit",
            "required": false,
            "description": "Máximo de coincidencias por nombre. Se ignora cuando q es un RNC o una cédula."
          }
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Consulta un contribuyente",
        "tags": [
          "Taxpayers"
        ],
        "description": "Devuelve la identidad del contribuyente y los datos disponibles de la DGII: categoría, estado del facturador electrónico, actividad económica, fecha de inicio de operaciones, régimen de pago, estado en la DGII y clasificación de la lista de implementación de facturación electrónica para contribuyentes locales y medianos de la DGII. La clasificación nula significa que no está disponible o no aparece en la lista; no permite determinar si el contribuyente es un gran contribuyente. La clasificación es independiente de la categoría y de la certificación del MICM. Los demás datos no disponibles son nulos. Los campos se combinan por identificador exacto a partir del directorio y las observaciones web guardadas de la DGII. Los valores ausentes y las actualizaciones fallidas no borran los datos disponibles.",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^(?:[0-9]{9}|[0-9]{11})$"
            },
            "in": "path",
            "name": "taxId",
            "required": true
          }
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Respuesta",
            "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": "Categoría tal como la publica la DGII; no es una forma jurídica ni una clasificación por tamaño de empresa."
                        },
                        "isElectronicInvoicer": {
                          "anyOf": [
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Indicador de facturador electrónico de la DGII. Un valor nulo significa desconocido, no falso."
                        },
                        "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": "Clasificación en la lista de implementación de facturación electrónica para contribuyentes locales y medianos de la DGII. Un valor nulo significa que no está disponible o no aparece en la lista; no permite determinar si el contribuyente es un gran contribuyente. Es independiente de la categoría y de la certificación del MICM."
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Lista los proveedores de tasas de cambio",
        "tags": [
          "Exchange rates"
        ],
        "description": "Lista los proveedores y la cobertura de fuentes calificadas.",
        "responses": {
          "200": {
            "description": "Respuesta",
            "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": "Respuesta",
            "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": "Obtén las tasas de cambio más recientes",
        "tags": [
          "Exchange rates"
        ],
        "description": "Devuelve cotizaciones calificadas y vigentes. Las fuentes secundarias solo se consideran con 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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Obtén el historial de tasas de cambio",
        "tags": [
          "Exchange rates"
        ],
        "description": "Devuelve cambios calificados capturados. Los intervalos vacíos no demuestran que los precios de un proveedor no hayan cambiado.",
        "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Lista los productos de combustibles",
        "tags": [
          "Fuel prices"
        ],
        "description": "Lista los productos dominicanos estables y la disponibilidad de precios calificados.",
        "responses": {
          "200": {
            "description": "Respuesta",
            "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": "Respuesta",
            "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": "Obtén un producto de combustible",
        "tags": [
          "Fuel prices"
        ],
        "description": "Obtén un producto de combustible y sus clasificaciones externas calificadas.",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
            },
            "in": "path",
            "name": "fuel",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Obtén los precios de combustibles aplicables",
        "tags": [
          "Fuel prices"
        ],
        "description": "Devuelve precios oficiales calificados para consumidores, aplicables en una fecha del calendario dominicano.",
        "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Obtén el historial de precios de combustibles",
        "tags": [
          "Fuel prices"
        ],
        "description": "Devuelve períodos calificados cuyos intervalos inclusivos de vigencia se superponen con las fechas solicitadas.",
        "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": "Respuesta",
            "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": {}
  }
}