{"openapi":"3.1.0","info":{"title":"API pública de parcerias · Nova Serrana · MG","version":"1.0.0","description":"Dados abertos das parcerias com organizações da sociedade civil (Lei 13.019/2014, art. 10). Somente leitura, sem autenticação, licença CC-BY 4.0. Limite de 300 requisições por minuto por endereço; respostas com cache de 5 minutos.","license":{"name":"CC-BY 4.0","identifier":"CC-BY-4.0"}},"servers":[{"url":"https://novaserrana.oscia.com.br/api/publico/v1"}],"tags":[{"name":"Dados abertos"},{"name":"Parcerias"}],"paths":{"/parcerias":{"get":{"summary":"Parcerias","description":"Termos de fomento, de colaboração e acordos de cooperação celebrados pelo município. Base legal: Lei 13.019/2014, art. 10. Atualização em tempo real.","tags":["Dados abertos"],"parameters":[{"name":"formato","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"CSV (separador \";\", UTF-8 com BOM) ou JSON"}],"responses":{"200":{"description":"Conjunto completo","content":{"application/json":{"schema":{"type":"object","properties":{"conjunto":{"type":"string"},"nome":{"type":"string"},"municipio":{"type":"string"},"gerado_em":{"type":"string","format":"date-time"},"fonte":{"type":"string"},"licenca":{"type":"string"},"total":{"type":"integer"},"campos":{"type":"array","items":{"type":"object"}},"dados":{"type":"array","items":{"$ref":"#/components/schemas/parcerias"}}}}},"text/csv":{"schema":{"type":"string"}}}},"429":{"description":"Limite de requisições excedido"}}}},"/organizacoes":{"get":{"summary":"Organizações","description":"Organizações da sociedade civil com parceria pública ou habilitadas no município. Base legal: Lei 13.019/2014, arts. 10 e 34. Atualização em tempo real.","tags":["Dados abertos"],"parameters":[{"name":"formato","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"CSV (separador \";\", UTF-8 com BOM) ou JSON"}],"responses":{"200":{"description":"Conjunto completo","content":{"application/json":{"schema":{"type":"object","properties":{"conjunto":{"type":"string"},"nome":{"type":"string"},"municipio":{"type":"string"},"gerado_em":{"type":"string","format":"date-time"},"fonte":{"type":"string"},"licenca":{"type":"string"},"total":{"type":"integer"},"campos":{"type":"array","items":{"type":"object"}},"dados":{"type":"array","items":{"$ref":"#/components/schemas/organizacoes"}}}}},"text/csv":{"schema":{"type":"string"}}}},"429":{"description":"Limite de requisições excedido"}}}},"/repasses":{"get":{"summary":"Repasses","description":"Liberações de recursos por parceria e competência. Base legal: Lei 13.019/2014, art. 10, V. Atualização em tempo real.","tags":["Dados abertos"],"parameters":[{"name":"formato","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"CSV (separador \";\", UTF-8 com BOM) ou JSON"}],"responses":{"200":{"description":"Conjunto completo","content":{"application/json":{"schema":{"type":"object","properties":{"conjunto":{"type":"string"},"nome":{"type":"string"},"municipio":{"type":"string"},"gerado_em":{"type":"string","format":"date-time"},"fonte":{"type":"string"},"licenca":{"type":"string"},"total":{"type":"integer"},"campos":{"type":"array","items":{"type":"object"}},"dados":{"type":"array","items":{"$ref":"#/components/schemas/repasses"}}}}},"text/csv":{"schema":{"type":"string"}}}},"429":{"description":"Limite de requisições excedido"}}}},"/despesas":{"get":{"summary":"Despesas","description":"Despesas apresentadas pelas organizações nas prestações de contas (sem dados de pessoa física). Base legal: Lei 13.019/2014, arts. 10 e 64. Atualização em tempo real.","tags":["Dados abertos"],"parameters":[{"name":"formato","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"CSV (separador \";\", UTF-8 com BOM) ou JSON"}],"responses":{"200":{"description":"Conjunto completo","content":{"application/json":{"schema":{"type":"object","properties":{"conjunto":{"type":"string"},"nome":{"type":"string"},"municipio":{"type":"string"},"gerado_em":{"type":"string","format":"date-time"},"fonte":{"type":"string"},"licenca":{"type":"string"},"total":{"type":"integer"},"campos":{"type":"array","items":{"type":"object"}},"dados":{"type":"array","items":{"$ref":"#/components/schemas/despesas"}}}}},"text/csv":{"schema":{"type":"string"}}}},"429":{"description":"Limite de requisições excedido"}}}},"/chamamentos":{"get":{"summary":"Chamamentos públicos","description":"Editais publicados, em andamento e concluídos, com resultado. Base legal: Lei 13.019/2014, arts. 23 a 32. Atualização em tempo real.","tags":["Dados abertos"],"parameters":[{"name":"formato","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"CSV (separador \";\", UTF-8 com BOM) ou JSON"}],"responses":{"200":{"description":"Conjunto completo","content":{"application/json":{"schema":{"type":"object","properties":{"conjunto":{"type":"string"},"nome":{"type":"string"},"municipio":{"type":"string"},"gerado_em":{"type":"string","format":"date-time"},"fonte":{"type":"string"},"licenca":{"type":"string"},"total":{"type":"integer"},"campos":{"type":"array","items":{"type":"object"}},"dados":{"type":"array","items":{"$ref":"#/components/schemas/chamamentos"}}}}},"text/csv":{"schema":{"type":"string"}}}},"429":{"description":"Limite de requisições excedido"}}}},"/emendas":{"get":{"summary":"Emendas parlamentares","description":"Recursos de emendas parlamentares vinculados a parcerias (art. 10, VII). Base legal: Lei 13.019/2014, art. 10, VII. Atualização em tempo real.","tags":["Dados abertos"],"parameters":[{"name":"formato","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"CSV (separador \";\", UTF-8 com BOM) ou JSON"}],"responses":{"200":{"description":"Conjunto completo","content":{"application/json":{"schema":{"type":"object","properties":{"conjunto":{"type":"string"},"nome":{"type":"string"},"municipio":{"type":"string"},"gerado_em":{"type":"string","format":"date-time"},"fonte":{"type":"string"},"licenca":{"type":"string"},"total":{"type":"integer"},"campos":{"type":"array","items":{"type":"object"}},"dados":{"type":"array","items":{"$ref":"#/components/schemas/emendas"}}}}},"text/csv":{"schema":{"type":"string"}}}},"429":{"description":"Limite de requisições excedido"}}}},"/prestacoes":{"get":{"summary":"Prestações de contas","description":"Prestações entregues pelas organizações e a situação da análise. Base legal: Lei 13.019/2014, arts. 10, VI, e 63 a 72. Atualização em tempo real.","tags":["Dados abertos"],"parameters":[{"name":"formato","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"CSV (separador \";\", UTF-8 com BOM) ou JSON"}],"responses":{"200":{"description":"Conjunto completo","content":{"application/json":{"schema":{"type":"object","properties":{"conjunto":{"type":"string"},"nome":{"type":"string"},"municipio":{"type":"string"},"gerado_em":{"type":"string","format":"date-time"},"fonte":{"type":"string"},"licenca":{"type":"string"},"total":{"type":"integer"},"campos":{"type":"array","items":{"type":"object"}},"dados":{"type":"array","items":{"$ref":"#/components/schemas/prestacoes"}}}}},"text/csv":{"schema":{"type":"string"}}}},"429":{"description":"Limite de requisições excedido"}}}},"/sancoes":{"get":{"summary":"Sanções vigentes","description":"Organizações com sanção vigente publicada (advertência, suspensão ou inidoneidade). Base legal: Lei 13.019/2014, art. 73. Atualização em tempo real.","tags":["Dados abertos"],"parameters":[{"name":"formato","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"CSV (separador \";\", UTF-8 com BOM) ou JSON"}],"responses":{"200":{"description":"Conjunto completo","content":{"application/json":{"schema":{"type":"object","properties":{"conjunto":{"type":"string"},"nome":{"type":"string"},"municipio":{"type":"string"},"gerado_em":{"type":"string","format":"date-time"},"fonte":{"type":"string"},"licenca":{"type":"string"},"total":{"type":"integer"},"campos":{"type":"array","items":{"type":"object"}},"dados":{"type":"array","items":{"$ref":"#/components/schemas/sancoes"}}}}},"text/csv":{"schema":{"type":"string"}}}},"429":{"description":"Limite de requisições excedido"}}}},"/ouvidoria":{"get":{"summary":"Ouvidoria (agregado)","description":"Quantidade de manifestações por tipo, situação e mês. Nunca o conteúdo. Base legal: Lei 13.460/2017. Atualização diária.","tags":["Dados abertos"],"parameters":[{"name":"formato","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"},"description":"CSV (separador \";\", UTF-8 com BOM) ou JSON"}],"responses":{"200":{"description":"Conjunto completo","content":{"application/json":{"schema":{"type":"object","properties":{"conjunto":{"type":"string"},"nome":{"type":"string"},"municipio":{"type":"string"},"gerado_em":{"type":"string","format":"date-time"},"fonte":{"type":"string"},"licenca":{"type":"string"},"total":{"type":"integer"},"campos":{"type":"array","items":{"type":"object"}},"dados":{"type":"array","items":{"$ref":"#/components/schemas/ouvidoria"}}}}},"text/csv":{"schema":{"type":"string"}}}},"429":{"description":"Limite de requisições excedido"}}}},"/parcerias/{id}":{"get":{"summary":"Ficha pública de uma parceria","tags":["Parcerias"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"formato","in":"query","required":false,"schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"Ficha com números, metas, repasses, prestações de contas e documentos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ficha_parceria"}}}},"404":{"description":"Parceria inexistente ou ainda não pública"}}}}},"components":{"schemas":{"parcerias":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Identificador permanente (UUID)"},"instrumento":{"type":["string","null"],"description":"TERMO_FOMENTO, TERMO_COLABORACAO ou ACORDO_COOPERACAO"},"numero":{"type":["string","null"],"description":"Número do termo no formato NN/AAAA"},"exercicio":{"type":["integer","null"],"description":"Ano do exercício"},"unidade_gestora":{"type":["string","null"],"description":"Órgão da Administração responsável"},"organizacao":{"type":["string","null"],"description":"Razão social da organização"},"cnpj":{"type":["string","null"],"description":"CNPJ da organização (14 dígitos)"},"objeto":{"type":["string","null"],"description":"Descrição do objeto"},"origem":{"type":["string","null"],"description":"CHAMAMENTO, DISPENSA ou INEXIGIBILIDADE"},"situacao":{"type":["string","null"],"description":"Situação atual (código interno)"},"situacao_publica":{"type":["string","null"],"description":"Situação em linguagem simples"},"celebrada_em":{"type":["string","null"],"format":"date","description":"Data de assinatura"},"vigencia_inicio":{"type":["string","null"],"format":"date","description":"Início da vigência"},"vigencia_fim":{"type":["string","null"],"format":"date","description":"Fim da vigência"},"valor":{"type":["number","null"],"description":"Valor total do repasse previsto (R$)"},"contrapartida":{"type":["number","null"],"description":"Contrapartida da organização (R$)"},"repassado":{"type":["number","null"],"description":"Valor já liberado (R$)"},"aprovado":{"type":["number","null"],"description":"Valor aplicado e aprovado na análise (R$)"},"glosado":{"type":["number","null"],"description":"Valor glosado (R$)"},"devolvido":{"type":["number","null"],"description":"Valor devolvido ao município (R$)"},"tem_emenda":{"type":["boolean","null"],"description":"Se há recurso de emenda parlamentar"},"url":{"type":["string","null"],"description":"Endereço da ficha pública"}}},"organizacoes":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Identificador permanente (UUID)"},"razao_social":{"type":["string","null"],"description":"Razão social"},"nome_fantasia":{"type":["string","null"],"description":"Nome fantasia"},"cnpj":{"type":["string","null"],"description":"CNPJ (14 dígitos)"},"areas_atuacao":{"type":"array","items":{"type":"string"},"description":"Áreas de atuação (códigos separados por |)"},"cidade":{"type":["string","null"],"description":"Cidade da sede"},"uf":{"type":["string","null"],"description":"UF da sede"},"situacao_publica":{"type":["string","null"],"description":"Situação cadastral em linguagem simples"},"parcerias":{"type":["integer","null"],"description":"Quantidade de parcerias públicas"},"valor_total":{"type":["number","null"],"description":"Soma dos valores das parcerias (R$)"},"sancao_vigente":{"type":["boolean","null"],"description":"Se há sanção vigente publicada"}}},"repasses":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Identificador (UUID)"},"parceria_id":{"type":["string","null"],"description":"Parceria"},"parceria":{"type":["string","null"],"description":"Instrumento e número"},"organizacao":{"type":["string","null"],"description":"Razão social"},"competencia":{"type":["string","null"],"description":"AAAA-MM"},"parcela":{"type":["integer","null"],"description":"Número da parcela"},"data":{"type":["string","null"],"format":"date","description":"Data da liberação"},"valor":{"type":["number","null"],"description":"Valor (R$)"},"empenho":{"type":["string","null"],"description":"Nota de empenho"},"situacao":{"type":["string","null"],"description":"LIBERADO ou ESTORNADO"}}},"despesas":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Identificador (UUID)"},"parceria_id":{"type":["string","null"],"description":"Parceria"},"parceria":{"type":["string","null"],"description":"Instrumento e número"},"competencia":{"type":["string","null"],"description":"AAAA-MM"},"categoria":{"type":["string","null"],"description":"Categoria de despesa (art. 46)"},"descricao":{"type":["string","null"],"description":"Descrição"},"fornecedor_cnpj":{"type":["string","null"],"description":"CNPJ do fornecedor (vazio quando pessoa física)"},"documento_fiscal":{"type":["string","null"],"description":"Tipo do documento fiscal"},"data_documento":{"type":["string","null"],"format":"date","description":"Data do documento"},"valor":{"type":["number","null"],"description":"Valor pago (R$)"},"situacao":{"type":["string","null"],"description":"Situação da análise"},"glosado":{"type":["number","null"],"description":"Valor glosado (R$)"}}},"chamamentos":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Identificador (UUID)"},"numero":{"type":["string","null"],"description":"Número do edital"},"exercicio":{"type":["integer","null"],"description":"Ano"},"titulo":{"type":["string","null"],"description":"Título"},"unidade_gestora":{"type":["string","null"],"description":"Órgão"},"instrumento":{"type":["string","null"],"description":"Instrumento a celebrar"},"valor_global":{"type":["number","null"],"description":"Valor global (R$)"},"publicado_em":{"type":["string","null"],"format":"date","description":"Publicação do edital"},"recebimento_inicio":{"type":["string","null"],"format":"date","description":"Início do recebimento de propostas"},"recebimento_fim":{"type":["string","null"],"format":"date","description":"Fim do recebimento"},"situacao":{"type":["string","null"],"description":"Situação"},"propostas":{"type":["integer","null"],"description":"Propostas recebidas"},"url":{"type":["string","null"],"description":"Endereço da página pública"}}},"emendas":{"type":"object","properties":{"parceria_id":{"type":["string","null"],"description":"Parceria"},"parceria":{"type":["string","null"],"description":"Instrumento e número"},"organizacao":{"type":["string","null"],"description":"Razão social"},"parlamentar":{"type":["string","null"],"description":"Autor da emenda"},"numero_emenda":{"type":["string","null"],"description":"Número da emenda"},"ano_emenda":{"type":["integer","null"],"description":"Ano da emenda"},"valor":{"type":["number","null"],"description":"Valor da fonte (R$)"},"descricao":{"type":["string","null"],"description":"Descrição da fonte"}}},"prestacoes":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Identificador (UUID)"},"parceria_id":{"type":["string","null"],"description":"Parceria"},"parceria":{"type":["string","null"],"description":"Instrumento e número"},"organizacao":{"type":["string","null"],"description":"Razão social"},"tipo":{"type":["string","null"],"description":"COMPETENCIA ou FINAL"},"competencia":{"type":["string","null"],"description":"AAAA-MM (vazio na final)"},"protocolo":{"type":["string","null"],"description":"Protocolo de entrega"},"enviada_em":{"type":["string","null"],"format":"date-time","description":"Entrega"},"situacao":{"type":["string","null"],"description":"Situação da análise"},"valor_apresentado":{"type":["number","null"],"description":"Valor apresentado (R$)"},"valor_aprovado":{"type":["number","null"],"description":"Valor aprovado (R$)"},"valor_glosado":{"type":["number","null"],"description":"Valor glosado (R$)"}}},"sancoes":{"type":"object","properties":{"processo":{"type":["string","null"],"description":"Número do processo"},"organizacao":{"type":["string","null"],"description":"Razão social"},"cnpj":{"type":["string","null"],"description":"CNPJ"},"tipo":{"type":["string","null"],"description":"Tipo da sanção"},"base_legal":{"type":["string","null"],"description":"Dispositivo"},"inicio":{"type":["string","null"],"format":"date","description":"Início da vigência"},"fim":{"type":["string","null"],"format":"date","description":"Fim da vigência"},"publicado_em":{"type":["string","null"],"format":"date","description":"Publicação"}}},"ouvidoria":{"type":"object","properties":{"mes":{"type":["string","null"],"description":"AAAA-MM do registro"},"tipo":{"type":["string","null"],"description":"Tipo da manifestação"},"situacao":{"type":["string","null"],"description":"Situação"},"quantidade":{"type":["integer","null"],"description":"Quantidade"},"dias_medios_resposta":{"type":["number","null"],"description":"Média de dias até a resposta"}}},"ficha_parceria":{"type":"object","description":"Mesma estrutura da ficha pública do portal; valores em reais","properties":{"id":{"type":"string","format":"uuid"},"rotulo":{"type":"string"},"objeto":{"type":"string"},"organizacao":{"type":"string"},"cnpj":{"type":"string"},"situacao":{"type":"string"},"situacao_publica":{"type":"string"},"resumo":{"type":"string"},"numeros":{"type":"object","properties":{"valor":{"type":"number"},"repassado":{"type":"number"},"aprovado":{"type":"number"},"glosado":{"type":"number"},"devolvido":{"type":"number"}}},"metas":{"type":"array","items":{"type":"object"}},"repasses":{"type":"array","items":{"type":"object"}},"prestacoes":{"type":"array","items":{"type":"object"}},"documentos":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string"},"titulo":{"type":"string"},"url":{"type":"string"}}}},"url":{"type":"string"}}}}}}