List bank codes
Good to know. Files supplied by Bank Al-Maghrib on 4 November 2026: separate institution and bank-code lists, with no automatic matching. BAM charter conditions require attribution and the copy date; commercial use requires written permission. Source labels remain in French.
Read the response
data: The requested results, as an object or an array.
meta: Dataset sources, license and dates. null means unknown or unavailable.
meta.pagination: Lists: 100 results by default, 500 maximum. Use limit and offset; meta.pagination.next_offset is null on the last page.
Illustrative example: With limit=10 and offset=0, the first page holds at most 10 results. If next_offset is 10, request the next page with offset=10 and the same filters. Stop when next_offset is null.
API v2 is the canonical path. Older /api/v1 paths remain compatibility aliases for the currently published behavior, including pagination; no removal date is scheduled.
Response fields 8
[] means each item in a list. null means unknown or unavailable, never zero. The guide language does not translate source values.
dataobject[]Requested result: a single object or a list.
data[].codestringThree-digit BAM bank code with leading zeros, distinct from a SWIFT/BIC code.
data[].namestringFrench label retained as supplied in the BAM workbook.
data[].category_codestringMoroccoAPI category code within this dataset.
data[].category_namestringCategory label retained as supplied by BAM.
data[].source_refobjectLocation of the observation in the source: sheet/row or basin/index.
data[].source_ref.sheetstringSource spreadsheet sheet name.
data[].source_ref.rowintegerSource spreadsheet row number, starting at 1.
Data structure
{
"type": "object",
"additionalProperties": false,
"required": [
"data",
"meta"
],
"properties": {
"data": {
"type": "array",
"items": {
"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",
"pagination"
],
"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}$"
}
}
}
},
"pagination": {
"type": "object",
"additionalProperties": false,
"required": [
"limit",
"offset",
"count",
"has_more",
"next_offset"
],
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 500
},
"has_more": {
"type": "boolean"
},
"next_offset": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
}
}
}
}
}
}
}Sources and pagination 31
metaobjectResult context: sources, dates, license and pagination where applicable.
meta.datasetstringName of the dataset for this result or source.
Accepted values:
"bam-banking"meta.producerstringOrganization publishing the original data.
Accepted values:
"Bank Al-Maghrib"meta.totalintegerNumber of matching records before pagination; not the size of this page.
meta.received_atstringDate of the BAM email supplying the files, separate from their reference date.
meta.copied_atstringCopy date used in the attribution required by BAM.
meta.transformation_versionstringVersion of the dataset conversion rules; separate from the API version.
meta.licensestringLocal identifier for the BAM charter conditions; not a standard open license.
Accepted values:
"LicenseRef-BAM-Charte-Diffusion"meta.terms_urlstringOfficial BAM charter on publishing data and statistics.
meta.terms_sectionstringCharter section defining the reuse conditions.
meta.attributionstringSource and copy-date attribution to retain when reusing the data.
meta.noticestringNotice of MoroccoAPI transformations and BAM non-liability.
meta.reuseobjectSummary of the charter conditions; consult the linked text.
meta.reuse.non_commercial_usestringNon-commercial reuse with BAM attribution and the copy date.
Accepted values:
"permitted-with-attribution-and-copy-date"meta.reuse.commercial_usestringWritten BAM permission is required for commercial use as defined by the charter.
Accepted values:
"written-permission-required"meta.reuse.modificationsstringDisclose changes and include a BAM non-liability notice.
Accepted values:
"disclose-changes-and-BAM-non-liability"meta.limitationsstring[]Known source or coverage limitations; read before using the data.
meta.sourcesobject[]Sources used for this result, with their publishers and licenses.
meta.sources[].datasetstringName of the dataset for this result or source.
Accepted values:
"institutions""bank-codes"meta.sources[].filenamestringName of the workbook attachment supplied by BAM.
meta.sources[].sheetstringSource spreadsheet sheet name.
meta.sources[].recordsintegerNumber of records in the source workbook before filtering.
meta.sources[].reference_datestring | nullSource reference date, or null when unstated; see date_basis.
meta.sources[].date_basisstringsource-filename: date from the filename; not-stated-in-workbook: no date stated in the workbook.
meta.sources[].sha256stringSHA-256 fingerprint identifying the original attachment; the raw workbook is not bundled.
meta.paginationobjectInformation for reading a collection one page at a time.
meta.pagination.limitintegerRequested maximum records per page: default 100, maximum 500.
meta.pagination.offsetintegerMatching records skipped before this page, after filtering. The first page starts at 0.
meta.pagination.countintegerNumber of records actually returned on this page.
meta.pagination.has_morebooleantrue when another page of records remains.
meta.pagination.next_offsetinteger | nullUse as offset for the next page; null at the end. Keep the same filters.
Errors
400: Invalid or missing parameter.
Errors return error.code, error.message and error.request_id.
errorobjectDetails of a failed request; replaces data and meta.
error.codestringStable error code, such as RESOURCE_NOT_FOUND; use it in application logic.
error.messagestringHuman-readable error explanation; use code for application logic.
error.request_idstringIdentifier for this request, useful when reporting a problem.