{"id":"91f03f80-101a-4e7e-9dec-caad79edddde","type":"API","name":"API Diffusion des Fichiers de Thèses sur theses.fr","slug":"api-diffusion-des-fichiers-de-theses-sur-thesesfr-2","description":"L’API gère la diffusion des fichiers de thèses, en accès libre ou en accès restreint, sur theses.fr. L'API s'adresse à toutes les personnes qui souhaitent récupérer les fichiers de thèses de doctorat, ou les modalités d’accès aux thèses de doctorat, pour les réutiliser au sein de leur propre systè…","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://www.data.gouv.fr/dataservices/api-diffusion-des-fichiers-de-theses-sur-theses-fr","docs_url":"https://theses.fr/","repo_url":null,"status":"ACTIVE","verification_state":"STALE","tags":["education","digital"],"logo_url":"https://udata-avatars.s3.rbx.io.cloud.ovh.net/4c/902079503b45a0bf3b8703e8136cf0-100.png","primary_source_url":"https://www.data.gouv.fr/dataservices/api-diffusion-des-fichiers-de-theses-sur-theses-fr","extraction_confidence":"0.40","created_at":"2026-06-07T22:08:37.299Z","updated_at":"2026-08-22T13:56:28.834Z","last_verified_at":"2026-08-19T11:23:39.966Z","deprecated_at":null,"ranking_score":58,"last_ranked_at":"2026-08-08T02:47:20.198Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-08-19T13:02:26.304Z","search_vector":"'a':189B 'abe':129B 'abes':279B 'about':253B 'acces':177B,181B,206B 'access':82B,85B,105B,232B,235B,255B 'accè':27B,31B,56B 'adress':38B 'adresse':188B 'agenc':123B,132B 'agence':273B 'agency':282B 'and':290B 'anyon':94B 'anyone':244B 'api':1A,9A,18B,36B,71B,151A,159A,168B,186B,221B 'appli':107B 'applying':257B 'at':294B 'au':64B,214B 'aux':57B,207B 'bibliograph':135B 'bibliographic':285B 'bibliographiqu':124B 'bibliographique':274B 'by':271B 'condit':106B 'conditions':256B 'cover':141B 'covers':291B 'd':55B,205B 'data':136B,286B 'de':5A,24B,48B,50B,59B,66B,125B,155A,174B,198B,200B,209B,216B,275B 'des':3A,22B,153A,172B 'diffus':2A,21B 'diffusion':152A,171B 'digit':150C 'distribut':11A,74B 'distribution':161A,224B 'doctor':76B,98B,142B 'doctoral':226B,248B,292B 'doctorat':51B,60B,201B,210B 'educ':139B,149C 'education':289B 'en':26B,30B,176B,180B 'enseign':127B 'enseignement':277B 'fichier':4A,23B,47B 'fichiers':154A,173B,197B 'file':14A,78B,100B 'files':164A,228B,250B 'for':160A,243B,260B,284B 'franc':148B 'france':298B 'french':131B,281B 'gere':169B 'gère':19B 'higher':138B,288B 'in':287B,297B 'inform':102B 'information':252B 'intend':92B 'intended':242B 'is':241B,269B 'it':240B,268B 'l':17B,35B,126B,167B,185B,276B 'la':20B,170B 'les':41B,46B,53B,62B,191B,196B,203B,212B 'leur':67B,217B 'level':146B,296B 'libr':28B 'libre':178B 'maintain':120B 'maintained':270B 'manag':72B 'manages':222B 'modalites':204B 'modalité':54B 'nation':145B 'national':295B 'of':162A,225B 'on':165A,236B 'open':81B,231B 'or':233B,251B,266B 'ou':29B,52B,179B,202B 'own':264B 'personn':42B 'personnes':192B 'platform':89B,239B 'pour':61B,211B 'propr':68B 'propre':218B 'qui':43B,193B 'recuperer':195B 'respons':133B 'responsible':283B 'restreint':32B,182B 'restrict':84B 'restricted':234B 'retriev':97B 'retrieve':247B 'reus':111B 'reuse':261B 'reutiliser':213B 'récupérer':45B 'réutilis':63B 's':187B 'sein':65B,215B 'servic':117B 'services':267B 'souhait':44B 'souhaitent':194B 'superieur':278B 'supérieur':128B 'sur':7A,33B,157A,183B 'syste':219B 'system':115B 'systems':265B 'systè':69B 'the':223B,237B,254B,272B,280B 'their':263B 'them':259B 'these':143B 'theses':156A,175B,199B,208B,293B 'theses.fr':8A,16A,34B,88B,158A,166A,184B,238B 'thesi':13A,77B,99B 'thesis':163A,227B,249B 'this':220B 'thèses':6A,25B,49B,58B 'to':246B,258B 'tout':40B 'toutes':190B 'under':230B 'whether':79B,229B 'wish':95B 'wishing':245B 'within':112B,262B 'à':39B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"ae8986bd-535c-4884-b8d4-19632fed1b73","institution_type":"AGENCY","country_code":"FR","official_confidence":40,"proof_summary":"official domain (data.gouv.fr) (catalog: api_gouv_fr)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-07T22:08:37.299Z","geographic_scope":"NATIONAL","name_en":"API for Distribution of Thesis Files on theses.fr","description_en":"This API manages the distribution of doctoral thesis files, whether under open access or restricted access, on the theses.fr platform. It is intended for anyone wishing to retrieve doctoral thesis files, or information about the access conditions applying to them, for reuse within their own systems or services. It is maintained by the Agence bibliographique de l'enseignement supérieur (ABES), the French agency responsible for bibliographic data in higher education, and covers doctoral theses at national level in France.","native_lang":"fr","access_level":"documented","formats":[],"capability_tier":"sample","trust_score":63.25,"access":{"level":"documented","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://theses.fr","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://theses.fr","source":"probe","runnable":true},{"kind":"spec","label":"OpenAPI spec","method":"GET","url":"https://theses.fr/api/v1/diffusion/openapi.yaml","source":"openapi","runnable":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://theses.fr/","source":"docs","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.data.gouv.fr/dataservices/api-diffusion-des-fichiers-de-theses-sur-theses-fr","source":"homepage","runnable":false}],"formats":[]},"maturity":{"entry_id":"91f03f80-101a-4e7e-9dec-caad79edddde","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"discovered","level_index":1,"level_label":"Discovered","meaning":"Source and metadata recorded","counts_as_coverage":false,"blocked_by":"verified","rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":false,"reached":false,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":true,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":false,"reached":false,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":40,"proven_threshold":80,"institution_id":"ae8986bd-535c-4884-b8d4-19632fed1b73","definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"www.data.gouv.fr","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-08-22T19:52:57.517Z"},"api_details":{"id":"febce103-74a3-4505-80da-dcb1232c7c55","entry_id":"91f03f80-101a-4e7e-9dec-caad79edddde","base_url":"https://theses.fr","openapi_url":"https://theses.fr/api/v1/diffusion/openapi.yaml","graphql_url":null,"api_version":null,"spec_format":"openapi","endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":"https://theses.fr","created_at":"2026-06-07T22:08:37.317Z","updated_at":"2026-06-07T22:08:37.317Z"},"dataset_details":null,"license":null,"reuse":{"license_id":null,"license_name":null,"license_url":null,"commercial_use":{"status":"unknown","value":null},"redistribution":{"status":"unknown","value":null},"attribution_required":{"status":"unknown","value":null},"share_alike":{"status":"unknown","value":null},"personal_data_warning":{"status":"unknown","value":null},"cache_and_mirror":{"status":"unknown","value":null},"undetermined":["commercial_use","redistribution","attribution_required","share_alike","personal_data_warning","cache_and_mirror"],"basis":"unverified","confidence":0.1,"confidence_tier":"low","source_text":null,"source_url":null,"reviewed_at":null},"license_raw":null,"latest_check":{"id":"f358e406-d229-417e-bc34-312d95e112aa","entry_id":"91f03f80-101a-4e7e-9dec-caad79edddde","status":"VERIFIED","last_checked_at":"2026-08-19T11:23:39.740Z","p50_latency_ms":1829,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:14.062Z","updated_at":"2026-08-19T11:23:39.740Z","consecutive_successes":7,"probe_url":"https://theses.fr","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/html;charset=utf-8","probe_succeeded_at":"2026-08-19T11:23:39.740Z"},"data_profile":{"id":"cfb77af2-6218-4797-8353-c1142eb8ab9d","entry_id":"91f03f80-101a-4e7e-9dec-caad79edddde","profile_source":"openapi","profile_kind":"dataset","dataset_id":null,"fields":[{"name":"nnt","role":"parameter","type":"string","label":null,"param_in":"path","required":true,"container":"/api/v1/document/{nnt}","filterable":true,"description":"Numéro National de Thèse","description_en":"National Thesis Number identifying the doctoral thesis."},{"name":"libelle","type":"string","label":"Bouton","description":null,"description_en":"Label text displayed on the access button."},{"name":"url","type":"string","label":"Bouton","description":null,"description_en":"URL linked to the access button."},{"name":"dateFin","type":"string","label":"Bouton","description":null,"description_en":"End date of the button's availability."},{"name":"typeAcces","type":"string","label":"Bouton","description":null,"enum_values":["ACCES_LIGNE","ACCES_ESR","EMBARGO","CONFIDENTIALITE","SUDOC"],"description_en":"Type of access granted by the button (e.g. open or restricted)."},{"name":"sousCategories","type":"array<object>","label":"Categorie","description":null,"description_en":"List of sub-categories within a category."},{"name":"boutons","type":"array<object>","label":"Categorie","description":null,"description_en":"List of access buttons belonging to a category."},{"name":"categories","type":"array<object>","label":"ResponseBoutons","description":null,"description_en":"List of categories grouping the available access buttons."}],"field_count":8,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://theses.fr/api/v1/diffusion/openapi.yaml","curl":"curl -s 'https://theses.fr/api/v1/diffusion/openapi.yaml' -H 'Accept: application/json'","label":"OpenAPI spec","method":"GET","description":"Machine-readable API description (use it to generate clients)."}],"status":"partial","error_message":null,"profiled_at":"2026-07-24T02:37:59.187Z","run_id":"27091eb3-d615-4405-98cf-1eb0dc7854db","created_at":"2026-07-16T23:08:46.154Z","updated_at":"2026-08-05T06:14:26.596Z","license_raw":null,"license_id":null,"consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":false},"datasets":[],"limits":[],"manifest":{"answer_sha256":"5d8903b721134a0acd0d363706fd753b56093b08f9da601ac4a2b0a129761cc2","answer_sha256_rule":"sha256 (hex, UTF-8) of JSON.stringify(this body) after deleting the keys listed in manifest.stamped_keys from manifest, and deleting manifest itself if it is then empty. The hash was computed before the stamp existed, so no field of the stamp is inside it.","stamped_keys":["answer_sha256","answer_sha256_rule","stamped_keys","row_count","row_count_basis","live","live_basis","created_at","created_at_basis","durable_citation"],"row_count":20,"row_count_basis":"Objects that are elements of a JSON array anywhere in this body, excluding manifest. Not a claim about which collection is the answer. Largest single collection: data_profile.fields[] (8 rows).","live":true,"live_basis":"This body was produced by executing the request.","created_at":"2026-08-22T19:52:57.668Z","created_at_basis":"When this response body was assembled, deliberately OUTSIDE the hashed bytes so the same answer hashes identically on every request. Not the upstream read time — that is provenance[].retrieved_at. A zone-cached replay carries the assembly time, not your receipt time.","durable_citation":"This manifest is produced at response time and is NOT stored. A durable, replayable citation is persisted only on an explicit cite: GET /api/v1/entries/{id-or-slug}/evidence, or the MCP cite_query tool. Both are entry-scoped, because evidence_manifests is entry-shaped; a domain answer spanning several sources has no single entry and cannot be persisted through that path."}}