Esta coleção reúne os endpoints utilizados pelas Instituições de Ensino para integração com o sistema de matrículas da SPTrans. Ela cobre autenticação, gestão de cadastro da instituição, gestão de turmas e operações de matrícula de estudantes.
\nA API permite que times de TI das instituições:
\nAutentiquem a integração da instituição com a SPTrans;
\nConsultem e gerenciem cursos e turmas;
\nRealizem matrícula individual ou em lote de estudantes;
\nConsultem e cancelem matrículas existentes;
\nAtualizem dados de acesso da instituição (email e senha).
\nLogin
\nExecute o endpoint Login para autenticar a instituição.
\nO login retorna um JWT e demais dados necessários, que são salvos nas variáveis de ambiente (como jwt, xsession e token).
Todos os demais endpoints dependem de uma autenticação válida.
\nGestão de Turmas e Cursos
\nUtilize os endpoints de Gestão de Turmas para listar cursos, consultar, criar e editar turmas.
\nEsses recursos são pré-requisitos para vincular corretamente as matrículas aos cursos/turmas corretos.
\nGestão de Matrículas
\nGestão de Cadastro da Instituição
\nAmbiente ativo: selecione o ambiente adequado (por exemplo, Produção).
Variáveis de ambiente: garantir que baseURL esteja configurada e visível; demais credenciais devem ser mantidas como variáveis seguras.
Chaves de acesso: quando requerido, informe x-api-key ou outros headers de autenticação/documentados nos próprios endpoints.
Utilize os exemplos já salvos em cada request para referência de respostas típicas (como 200, 401, 403).
\nOs scripts de teste existentes propagam automaticamente jwt/xsession após um login bem-sucedido — não altere esses scripts ao consumir a coleção.
Recomenda-se seguir a ordem lógica das pastas (Login → Gestão de Turmas → Gestão de Matrículas → Gestão de Cadastro) ao explorar e testar a API.
\nPara utilizar as APIs, é necessário possuir:
\nAPI Key do Documento do Estudante (DNE)
\nSolicite a sua através do e-mail: instituicao.sptrans@dne.com.br
\nUsuário e senha da SPTrans
\nOs mesmos utilizados para acesso ao portal institucional da SPTrans.
\nEm caso de dúvidas ou necessidade de suporte, nossa equipe está à disposição.
\nCanal de atendimento: instituicao.sptrans@dne.com.br
\nOu entre em contato com o gerente de integração responsável pela sua instituição.
\nRealiza o login da Instituição de Ensino no sistema de matrículas da SPTrans.
\njwt, xsession, token etc.).Os demais endpoints utilizam essas variáveis para autenticação automática via headers.
\n","urlObject":{"path":["auth","integration","login"],"host":["https://sptrans-institution.documentodoestudante.com.br"],"query":[],"variable":[]}},"response":[{"id":"bdcda5e1-c32d-449a-a79f-88f902635ebe","name":"200","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-api-key","value":"{{x_api_key}}"}],"body":{"mode":"raw","raw":"{\n \"username\": {{username}},\n \"password\": \"{{password}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sptrans-institution.documentodoestudante.com.br/auth/integration/login"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":":status","value":200},{"key":"date","value":"Wed, 28 Jan 2026 16:42:10 GMT"},{"key":"content-type","value":"application/json;charset=UTF-8"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"referrer-policy","value":"same-origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"strict-transport-security","value":"max-age=15552000"},{"key":"report-to","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=fd%2Bn1GcesnLFT6GXV8tbJ1FALndYTW5FUsSRywJEeRkudRyj54r09XKmt5ANZ0TgilNz1WSt0dNd1YMlwBBHKyAK6HXWRVezM9R7HCBekKi7uFhEspcbcsOfAw%2FTUBCTMqxejwUNNwxz%2Bj1Yzg0%3D\"}]}"},{"key":"nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"expect-ct","value":"max-age=86400, enforce"},{"key":"content-encoding","value":"br"},{"key":"server","value":"cloudflare"},{"key":"cf-ray","value":"9c51f100aa0db6e6-GRU"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"jwt\": \"eyJhbGciOiJIUzUxMiJ9.eyJleHAiOjE3Njk3MDQ5MzAsInN1YiI6IjEzMDAwMSIsInNjaG9vbCI6MTMwMDAxLCJpYXQiOjE3Njk2MTg1MzB9.k3r1TvRgf7CNh_z17OmTnFVngzaHZGqh0XC2G6WElVAiwrZqotTsk1sMnh1aZlqf6aetKoimzecjN83rjUFQ-w\",\n \"school\": {\n \"schoolId\": 130001,\n \"createdAt\": null,\n \"updatedAt\": \"2026-01-28T13:42:10.034889036\",\n \"name\": \"FACULDADE TESTE SPTRANS\",\n \"fantasyName\": \"SPTRANS\",\n \"addressStreet\": \"RUA JOAQUIM CARLOS\",\n \"addressQuarter\": \"PARI\",\n \"addressNumber\": \"655\",\n \"addressComplement\": \"TESTE\",\n \"addressZipCode\": \"03019000\",\n \"telephoneNumber\": \"32932787\",\n \"telephoneBranch\": \"2787\",\n \"email\": \"dne@documentodoestudante.com.br\",\n \"mecNumber\": \"130001\",\n \"establishmentTypeId\": 4,\n \"establishmentTypeDescription\": \"Particular\",\n \"levelTypeId\": 2,\n \"levelTypeDescription\": \"Universidade dentro do Município\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"classes\": []\n },\n \"expiresAt\": \"2026-01-28 13:57:09\",\n \"firstLogin\": false\n}"},{"id":"24f8c181-0435-4acb-b5f8-74e68aca6a87","name":"401","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-api-key","value":"{{x_api_key}}"}],"body":{"mode":"raw","raw":"{\n \"username\": {{username}},\n \"password\": \"{{password}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sptrans-institution.documentodoestudante.com.br/auth/integration/login"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":":status","value":401},{"key":"date","value":"Wed, 28 Jan 2026 16:43:16 GMT"},{"key":"content-type","value":"application/json;charset=UTF-8"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"referrer-policy","value":"same-origin"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"strict-transport-security","value":"max-age=15552000"},{"key":"report-to","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=olOYWwgYPAabbkzqFkKKB75ao63y1zqc7cMFy%2BM%2Fk6jZHlWno69D1Z4UERLMNrcYP8j1IvbN68pZBNk%2B3OXmLx%2BhznePhCsijiklBFmWN7HeyazslkqWkblFiJ%2FZsnhWnGXCHNRZY2%2FTdwONo8o%3D\"}]}"},{"key":"nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"expect-ct","value":"max-age=86400, enforce"},{"key":"server","value":"cloudflare"},{"key":"cf-ray","value":"9c51f28769bbb6e6-GRU"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"message\": \"Usuário ou senha inválidos.\"\n}"},{"id":"0c9ee1a6-0ca4-4560-a1e7-ac47c6ffcc86","name":"403","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-api-key","value":"{{x_api_key}}"}],"body":{"mode":"raw","raw":"{\n \"username\": {{username}},\n \"password\": \"{{password}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sptrans-institution.documentodoestudante.com.br/auth/integration/login"},"status":"Forbidden","code":403,"_postman_previewlanguage":null,"header":[{"key":":status","value":403},{"key":"date","value":"Wed, 28 Jan 2026 16:44:24 GMT"},{"key":"content-length","value":"0"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"strict-transport-security","value":"max-age=15552000"},{"key":"report-to","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=UhpZ9IX%2FUWF4TjM4EyzwoYABKLZBbYp3470PHgsqr2a3kwvi9OQ2A6QypxNaXHHjwXKlQtIqxsM10KXqu9IpDHZMc%2FFptkwA%2FWRjcGvtFBa8Wxjn70NibIFlF%2F0ythu5STDbegmXzLnaJ2EEaP0%3D\"}]}"},{"key":"nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"expect-ct","value":"max-age=86400, enforce"},{"key":"referrer-policy","value":"same-origin"},{"key":"server","value":"cloudflare"},{"key":"cf-ray","value":"9c51f44afc6eb6e6-GRU"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":null},{"id":"c36647d3-35df-4e69-9f1c-c54a23dc3d2f","name":"500","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-api-key","value":"{{x_api_key}}"}],"body":{"mode":"raw","raw":"{\n \"username\": {{username}},\n \"password\": \"{{password}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sptrans-institution.documentodoestudante.com.br/auth/integration/login"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":null,"header":[{"key":":status","value":500},{"key":"date","value":"Wed, 28 Jan 2026 17:14:30 GMT"},{"key":"content-length","value":"0"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"expires","value":"0"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"strict-transport-security","value":"max-age=15552000"},{"key":"report-to","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=dN5hRnFcSi2qsE6mib36TuG4mxH763nr34w8lNmdDgzXS6c76aa5qDcOlG4UeLkSt%2FArJdkSU4Yn0pZlDhsiYivEtrDNraCo7gm1PBAvjd9DOktk3YE93czmk%2Br%2BP21wab6Y8b8L7PnM05B9ceo%3D\"}]}"},{"key":"nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"expect-ct","value":"max-age=86400, enforce"},{"key":"referrer-policy","value":"same-origin"},{"key":"server","value":"cloudflare"},{"key":"cf-ray","value":"9c52205fdeab7a2f-GRU"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"c25c7090-935c-409e-89d0-f2d1c64b13a8"}],"id":"2e1c1712-898d-4a71-9d7b-020962f61b79","description":"Primeiro passo para acessar o Sistema de Matrículas da SPTrans.
\nUse o endpoint desta pasta para:
\njwt, xsession, token).\n\n","event":[{"listen":"prerequest","script":{"id":"93d22bbc-1174-4218-888c-0b4830567cc0","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"14268dc8-1123-4548-9d2e-8d953b47f4f5","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"2e1c1712-898d-4a71-9d7b-020962f61b79"},{"name":"Gestão de Matrículas","item":[{"name":"Consultar estudante","id":"fea75dbe-266c-46a5-8033-bf246273a857","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"{{jwt}}","type":"text"}],"url":"https://sptrans-institution.documentodoestudante.com.br/enrollment/classUserDetails?cpf=45022977800","description":"Após executar o login com sucesso, todos os outros endpoints da collection passam a utilizar as credenciais retornadas, seja via header ou variáveis.
\n
Consulta os detalhes de matrícula de um estudante específico em uma determinada turma e curso.
\ncpf: CPF do estudante;courseCode: código do curso;classId: identificador da turma.Lista todos os estudantes matriculados em uma turma específica.
\nclassId e/ou parâmetros equivalentes).Registra ou atualiza a matrícula de um único estudante em uma turma.
\nQuando usar:
\nPara processar matrículas pontuais (casos isolados);
\nPara corrigir dados de matrícula de um único aluno.
\nEntrada: dados do estudante (ex.: CPF), curso, turma e demais campos obrigatórios definidos pelo backend.
\nSaída: confirmação da matrícula ou atualização, com dados da operação realizada.
\nPermite o envio de múltiplas matrículas de estudantes em uma única requisição.
\nCancela a matrícula de um estudante em uma turma.
\nclassId, courseCode ou outro identificador definido na API).Centraliza todas as operações de gerenciamento de matrículas de alunos na plataforma.
\nNesta pasta você pode:
\n\n\n","event":[{"listen":"prerequest","script":{"id":"1f46e75c-091c-4561-9fbd-873058969b7c","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"478eb74c-322a-4a5d-88df-5884a488225f","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"6046bb5d-8ad2-4a4b-ad28-559b6d85f9fc"},{"name":"Gestão de Turmas","item":[{"name":"Editar Turmas","id":"4fa5f60d-f3f7-4af6-a62b-3aa5dcb9b685","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"courseCode\": \"5108\",\n \"schoolCourseId\": 1,\n \"description\": \"Teste Alterado2\",\n \"grade\": \"1º TERMO 2\",\n \"initialDate\": \"01/01/2025\",\n \"finalDate\": \"31/05/2025\",\n \"startHour\": \"13:30\",\n \"endHour\": \"16:30\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sptrans-institution.documentodoestudante.com.br/enrollment/editClass","description":"Recomendado executar antes:
\n\n
\n- Login da Instituição de Ensino;
\n- Configuração prévia de cursos e turmas na pasta Gestão de Turmas.
\n
Atualiza dados de uma turma já existente.
\nQuando usar:
\nPara corrigir informações cadastradas incorretamente;
\nPara ajustar dados da turma (por exemplo, horário, quantidade de vagas) conforme necessidade operacional.
\nEntrada: identificador da turma e campos que serão atualizados.
\nSaída: confirmação da atualização e, opcionalmente, os dados atualizados da turma.
\nLista todos os cursos oferecidos pela Instituição de Ensino que estão disponíveis no sistema de matrículas da SPTrans.
\nQuando usar:
\nPara obter o courseCode a ser utilizado em outras operações (turmas e matrículas);
Para conferência e integração do catálogo de cursos local com o catálogo registrado na SPTrans.
\nSaída: coleção de cursos com identificadores e metadados relevantes (código do curso, nome, status etc.).
\nConsulta os detalhes completos de uma turma específica.
\nclassId e/ou outros parâmetros definidos pelo backend).Retorna a lista de turmas cadastradas para a Instituição de Ensino, opcionalmente filtrando se são turmas do próximo ano letivo.
\nclassId a ser utilizado em consultas de estudantes e operações de matrícula.nextYear (query): indica se a listagem deve considerar turmas do próximo ano letivo (true ou false).Cria uma nova turma vinculada a um curso da Instituição de Ensino.
\nclassId).Conjunto de endpoints para administrar as turmas vinculadas aos cursos da Instituição de Ensino.
\nCom estes endpoints é possível:
\n\n\n","event":[{"listen":"prerequest","script":{"id":"61c59796-c0c4-444c-9901-d03becf45e9a","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"000b1662-df63-41b3-8198-5cd281a30a30","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"f8fdd16e-a851-4a7b-be4c-4a1175d8f030"},{"name":"Gestão de Cadastro","item":[{"name":"Atualizar email escola","id":"13a95ee4-8b35-4a67-9c70-497453c9cdf4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{jwt}}"}],"body":{"mode":"raw","raw":"{\n \"email\": \"dev@dne.com.br\"\n}","options":{"raw":{"language":"json"}}},"url":"https://sptrans-institution.documentodoestudante.com.br/enrollment/changeEmail","description":"As turmas criadas e mantidas aqui são usadas como referência na Gestão de Matrículas, para vincular cada aluno à turma correta.
\n
Atualiza o e-mail de cadastro da Instituição de Ensino no sistema de matrículas.
\nAtualiza a senha de acesso da Instituição de Ensino ao sistema de matrículas.
\nGerenciamento dos dados de acesso e contato da Instituição de Ensino.
\nNesta pasta é possível:
\nAtualizar o e-mail de cadastro (contato principal);
\nAtualizar a senha de acesso ao sistema de matrículas.
\n\n\n","event":[{"listen":"prerequest","script":{"id":"e25e13da-4eb2-494c-bc29-e40853e325a3","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"96d7b9de-844e-4d13-9ad9-4c90e1f5f118","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"0eece9ea-0910-41a0-8416-f11b4426779a"}],"event":[{"listen":"prerequest","script":{"id":"708e1421-6bb6-4ad2-8bd5-c97500781fb6","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"b43c9721-6994-48d0-8dea-2ff6a69d41b9","type":"text/javascript","exec":[""]}}],"variable":[{"key":"baseURL","value":"https://sptrans-institution.documentodoestudante.com.br","type":"default"}]}Utilize estes endpoints sempre que houver troca de responsável, mudança de e-mail institucional ou necessidade de redefinição da senha de acesso.
\n