Chercher un code bancaire
À savoir. Fichiers transmis par Bank Al-Maghrib le 4 novembre 2026 : établissements et codes bancaires séparés, sans rapprochement automatique. Conditions de la charte BAM : attribution et date de copie ; usage commercial soumis à autorisation écrite. Données conservées en français.
Comprendre la réponse
data: Les résultats demandés, sous forme d’objet ou de liste.
meta: Sources, licence et dates du jeu de données. null signifie une valeur inconnue ou indisponible.
API v2 est le chemin de référence. Les anciens chemins /api/v1 restent des alias de compatibilité du comportement actuellement publié, pagination comprise ; aucune date de suppression n’est fixée.
Champs renvoyés 8
[] désigne chaque élément d’une liste. null signifie inconnu ou indisponible, jamais zéro. La langue du guide ne traduit pas les valeurs des sources.
dataobjectRésultat demandé : objet unique ou liste.
data.codestringCode bancaire BAM à trois chiffres, avec zéros initiaux. Distinct d’un code SWIFT/BIC.
data.namestringLibellé conservé tel qu’il figure dans le fichier BAM, en français.
data.category_codestringCode MoroccoAPI de la catégorie dans ce référentiel.
data.category_namestringCatégorie conservée telle que fournie par BAM.
data.source_refobjectRepère de l’observation dans la source : feuille/ligne ou bassin/index.
data.source_ref.sheetstringNom de la feuille du tableur source.
data.source_ref.rowintegerNuméro de ligne du tableur source, commençant à 1.
Structure des données
{
"type": "object",
"additionalProperties": false,
"required": [
"data",
"meta"
],
"properties": {
"data": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"name",
"category_code",
"category_name",
"source_ref"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[0-9]{3}$",
"description": "Three-digit BAM bank code, preserving leading zeros. Not a SWIFT/BIC code."
},
"name": {
"type": "string",
"minLength": 1
},
"category_code": {
"type": "string",
"minLength": 1
},
"category_name": {
"type": "string",
"minLength": 1
},
"source_ref": {
"type": "object",
"additionalProperties": false,
"required": [
"sheet",
"row"
],
"properties": {
"sheet": {
"type": "string",
"minLength": 1
},
"row": {
"type": "integer",
"minimum": 1
}
}
}
}
},
"meta": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"producer",
"total",
"received_at",
"copied_at",
"transformation_version",
"license",
"terms_url",
"terms_section",
"attribution",
"notice",
"reuse",
"limitations",
"sources"
],
"properties": {
"dataset": {
"enum": [
"bam-banking"
]
},
"producer": {
"enum": [
"Bank Al-Maghrib"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"received_at": {
"type": "string",
"format": "date"
},
"copied_at": {
"type": "string",
"format": "date"
},
"transformation_version": {
"type": "string",
"minLength": 1
},
"license": {
"enum": [
"LicenseRef-BAM-Charte-Diffusion"
]
},
"terms_url": {
"type": "string",
"format": "uri"
},
"terms_section": {
"type": "string",
"minLength": 1
},
"attribution": {
"type": "string",
"minLength": 1
},
"notice": {
"type": "string",
"minLength": 1
},
"reuse": {
"type": "object",
"additionalProperties": false,
"required": [
"non_commercial_use",
"commercial_use",
"modifications"
],
"properties": {
"non_commercial_use": {
"enum": [
"permitted-with-attribution-and-copy-date"
]
},
"commercial_use": {
"enum": [
"written-permission-required"
]
},
"modifications": {
"enum": [
"disclose-changes-and-BAM-non-liability"
]
}
}
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"sources": {
"type": "array",
"minItems": 2,
"maxItems": 2,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"filename",
"sheet",
"records",
"reference_date",
"date_basis",
"sha256"
],
"properties": {
"dataset": {
"type": "string",
"enum": [
"institutions",
"bank-codes"
]
},
"filename": {
"type": "string",
"minLength": 1
},
"sheet": {
"type": "string",
"minLength": 1
},
"records": {
"type": "integer",
"minimum": 1
},
"reference_date": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"date_basis": {
"type": "string",
"minLength": 1
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
}
}
}
}
}
}Sources et pagination 25
metaobjectContexte du résultat : sources, dates, licence et pagination si applicable.
meta.datasetstringNom du jeu de données auquel appartient le résultat ou la source.
Valeurs acceptées:
"bam-banking"meta.producerstringOrganisme qui publie la donnée originale.
Valeurs acceptées:
"Bank Al-Maghrib"meta.totalintegerNombre de résultats correspondant aux filtres, avant pagination ; pas la taille de cette page.
meta.received_atstringDate du courriel BAM transmettant les fichiers, distincte de leur date de référence.
meta.copied_atstringDate de copie utilisée dans l’attribution demandée par BAM.
meta.transformation_versionstringVersion des règles de conversion du jeu de données ; distincte de l’API.
meta.licensestringIdentifiant local des conditions de la charte BAM ; ne désigne pas une licence ouverte standard.
Valeurs acceptées:
"LicenseRef-BAM-Charte-Diffusion"meta.terms_urlstringCharte officielle BAM sur la diffusion des données et statistiques.
meta.terms_sectionstringSection de la charte définissant les conditions de réutilisation.
meta.attributionstringMention de la source et de la date de copie à conserver lors de la réutilisation.
meta.noticestringMention des transformations MoroccoAPI et de la non-responsabilité de BAM.
meta.reuseobjectRésumé des conditions de la charte ; consulter le texte lié.
meta.reuse.non_commercial_usestringRéutilisation non commerciale avec mention de BAM et de la date de copie.
Valeurs acceptées:
"permitted-with-attribution-and-copy-date"meta.reuse.commercial_usestringUne autorisation écrite de BAM est requise pour l’usage commercial défini par la charte.
Valeurs acceptées:
"written-permission-required"meta.reuse.modificationsstringInformer des modifications et inclure une clause de non-responsabilité de BAM.
Valeurs acceptées:
"disclose-changes-and-BAM-non-liability"meta.limitationsstring[]Limites connues de la source ou de la couverture ; à lire avant d’utiliser les données.
meta.sourcesobject[]Sources utilisées pour ce résultat, avec leurs producteurs et licences.
meta.sources[].datasetstringNom du jeu de données auquel appartient le résultat ou la source.
Valeurs acceptées:
"institutions""bank-codes"meta.sources[].filenamestringNom du fichier joint transmis par BAM.
meta.sources[].sheetstringNom de la feuille du tableur source.
meta.sources[].recordsintegerNombre de fiches contenues dans le fichier source, avant filtrage.
meta.sources[].reference_datestring | nullDate de référence indiquée par la source, ou null si non précisée ; voir date_basis.
meta.sources[].date_basisstringsource-filename : date tirée du nom du fichier ; not-stated-in-workbook : date non précisée dans le classeur.
meta.sources[].sha256stringEmpreinte SHA-256 identifiant la pièce jointe originale ; le classeur brut n’est pas inclus.
Erreurs
400: Paramètre invalide ou manquant.404: Ressource introuvable.
Les erreurs renvoient error.code, error.message et error.request_id.
errorobjectDétails d’une requête échouée ; remplace data et meta.
error.codestringCode stable de l’erreur, par exemple RESOURCE_NOT_FOUND ; à utiliser dans votre logique.
error.messagestringExplication lisible de l’erreur ; utilisez code pour la logique de votre application.
error.request_idstringIdentifiant du traitement de cette requête, utile pour retrouver un problème.