> ## Documentation Index > Fetch the complete documentation index at: https://docs.plumaa.id/llms.txt > Use this file to discover all available pages before exploring further. # List Issuers ## OpenAPI ````yaml get /issuers openapi: 3.0.1 info: title: Plumaa ID API version: 1.0.0 description: Generated by SOFA servers: - url: https://api.plumaa.id/rest/v1 description: Production - url: https://api.staging.plumaa.id/rest/v1 description: Staging security: - apiKey: [] tags: - name: ApiKey description: ApiKey related operations - name: Certificate description: Certificate related operations - name: Issuer description: Issuer related operations - name: Organization description: Organization related operations - name: OrganizationLink description: OrganizationLink related operations - name: OrganizationMember description: OrganizationMember related operations - name: SignatureRequestInvite description: SignatureRequestInvite related operations - name: SignatureRequest description: SignatureRequest related operations - name: Subject description: Subject related operations - name: Witness description: Witness related operations - name: Other description: Other operations - name: Timeseries description: Timeseries related operations - name: PriceOracle description: Aggregated indexed price data - name: Wallet description: Wallet related operations - name: Endorsable description: Endorsable related operations - name: EndorseEvent description: Endorsable transfer event related operations paths: /issuers: get: tags: - Issuer operationId: issuers_query parameters: - name: _id in: query required: false schema: $ref: '#/components/schemas/ObjectIDArg' - name: search in: query required: false schema: $ref: '#/components/schemas/IssuerSearchArg' - name: postalCode in: query required: false schema: $ref: '#/components/schemas/NonNegativeIntArg' - name: country in: query required: false schema: $ref: '#/components/schemas/IDArg' - name: createdAt in: query required: false schema: $ref: '#/components/schemas/DateRangeArg' - name: updatedAt in: query required: false schema: $ref: '#/components/schemas/DateRangeArg' - name: sort in: query required: false schema: $ref: '#/components/schemas/IssuerSortArg' - name: pagination in: query required: false schema: $ref: '#/components/schemas/Pagination' responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/Issuers' components: schemas: ObjectIDArg: type: object properties: exists: type: boolean description: >- If provided, it will apply an $exists filter. See https://www.mongodb.com/docs/manual/reference/operator/query/exists/#-exists eq: description: >- If provided, it will apply an $eq filter. See https://www.mongodb.com/docs/manual/reference/operator/query/eq/#op._S_eq ne: description: >- If provided, it will apply a $ne filter. See https://www.mongodb.com/docs/manual/reference/operator/query/ne/#op._S_ne in: type: array items: description: >- A field whose value conforms with the standard mongodb object ID as described here: https://docs.mongodb.com/manual/reference/method/ObjectId/#ObjectId. Example: 5e5677d71bdc2ae76344968c description: >- If provided, it will apply an $in filter. See https://www.mongodb.com/docs/manual/reference/operator/query/in/#op._S_in nin: type: array items: description: >- A field whose value conforms with the standard mongodb object ID as described here: https://docs.mongodb.com/manual/reference/method/ObjectId/#ObjectId. Example: 5e5677d71bdc2ae76344968c description: >- If provided, it will apply a $nin filter. See https://www.mongodb.com/docs/manual/reference/operator/query/nin/#op._S_nin description: ObjectID matching arguments. IssuerSearchArg: type: object properties: commonName: type: string description: Matches a similar string in the commonName field. organization: type: string description: Matches a similar string in the organization field. organizationalUnitName: type: string description: Matches a similar string in the organizationalUnitName field. emailAddress: type: string description: Matches a similar string in the emailAddress field. streetAddress: type: string description: Matches a similar string in the streetAddress field. stateOrProvinceName: type: string description: Matches a similar string in the stateOrProvinceName field. localityName: type: string description: Matches a similar string in the localityName field. description: Search arguments for Issuers query. NonNegativeIntArg: type: object properties: exists: type: boolean description: >- If provided, it will apply an $exists filter. See https://www.mongodb.com/docs/manual/reference/operator/query/exists/#-exists eq: description: >- If provided, it will apply an $eq filter. See https://www.mongodb.com/docs/manual/reference/operator/query/eq/#op._S_eq ne: description: >- If provided, it will apply a $ne filter. See https://www.mongodb.com/docs/manual/reference/operator/query/ne/#op._S_ne in: type: array items: description: Integers that will have a value of 0 or more. description: >- If provided, it will apply an $in filter. See https://www.mongodb.com/docs/manual/reference/operator/query/in/#op._S_in nin: type: array items: description: Integers that will have a value of 0 or more. description: >- If provided, it will apply a $nin filter. See https://www.mongodb.com/docs/manual/reference/operator/query/nin/#op._S_nin description: NonNegativeInt matching arguments. IDArg: type: object properties: exists: type: boolean description: >- If provided, it will apply an $exists filter. See https://www.mongodb.com/docs/manual/reference/operator/query/exists/#-exists eq: type: string description: >- If provided, it will apply an $eq filter. See https://www.mongodb.com/docs/manual/reference/operator/query/eq/#op._S_eq ne: type: string description: >- If provided, it will apply a $ne filter. See https://www.mongodb.com/docs/manual/reference/operator/query/ne/#op._S_ne in: type: array items: type: string description: >- If provided, it will apply an $in filter. See https://www.mongodb.com/docs/manual/reference/operator/query/in/#op._S_in nin: type: array items: type: string description: >- If provided, it will apply a $nin filter. See https://www.mongodb.com/docs/manual/reference/operator/query/nin/#op._S_nin description: ID matching arguments. DateRangeArg: type: object properties: exists: type: boolean description: If provided, it will apply an $exists filter. lte: description: Lower than or equal to. gte: description: Greater than or equal to. description: Date range arguments. IssuerSortArg: type: object required: - field - order properties: field: type: string enum: - createdAt - updatedAt description: The field to sort results by. order: type: string enum: - asc - desc description: The order to sort by. description: Sort arguments for ApiCalls query. Pagination: type: object required: - page - size properties: page: description: Page number. Starts at 1. size: description: Page size. description: Pagination arguments. Issuers: type: object required: - id - info - results properties: id: type: string info: $ref: '#/components/schemas/ResultsInfo' description: Pagination info. results: type: array items: $ref: '#/components/schemas/Issuer' description: List of Issuers. description: Results of an Issuers query. ResultsInfo: type: object required: - id properties: id: type: string count: description: Total number of items pages: description: Total amount of pages next: description: Next page prev: description: Previous page description: Pagination info about the results of a query. Issuer: type: object required: - id - hash - commonName - publicKey - certificatePem - createdAt - updatedAt properties: id: description: >- A field whose value conforms with the standard mongodb object ID as described here: https://docs.mongodb.com/manual/reference/method/ObjectId/#ObjectId. Example: 5e5677d71bdc2ae76344968c RFC: type: string description: RFC of the issuer. hash: description: The hash of the issuer's certificate. commonName: type: string description: The name of the certificate authority. organization: type: string description: |- Name of the organization or company. "Razón Social" in Spanish. organizationalUnitName: type: string description: |- Name of the unit within the organization. "Unidad Organizacional" in Spanish. emailAddress: description: Email address of the issuer. streetAddress: type: string description: Street address of the issuer. postalCode: type: integer format: int32 description: Postal code of the issuer. country: description: '"Country" of the issuer.' stateOrProvinceName: type: string description: '"Entidad Federativa" of the issuer.' localityName: type: string description: '"Municipio/Delegación" of the issuer.' publicKey: $ref: '#/components/schemas/PublicKey' description: >- The issuer's certificate public key. This is the public key that identifies messages the issuer has signed a certificate for a subject. certificatePem: type: string description: AWS S3 URI path to the issuer certificate's PEM data. createdAt: description: >- A date-time string at UTC, such as 2007-12-03T10:15:30Z, compliant with the `date-time` format outlined in section 5.6 of the RFC 3339 profile of the ISO 8601 standard for representation of dates and times using the Gregorian calendar. updatedAt: description: >- A date-time string at UTC, such as 2007-12-03T10:15:30Z, compliant with the `date-time` format outlined in section 5.6 of the RFC 3339 profile of the ISO 8601 standard for representation of dates and times using the Gregorian calendar. description: |- An Issuer is a Certificate Authority certified by Banxico to issue digital signature certificates to Mexican citizens. PublicKey: type: object required: - exponent - modulus properties: exponent: description: The public key's modulus, as a hexadecimal string. modulus: description: The public key's exponent, as a hexadecimal string. description: An RSA public key, as defined in RFC 3447. securitySchemes: apiKey: type: http scheme: bearer ````