# Get Authorized Merchant Store List

Retrieves authorized merchant store list with basic store information and pagination data.

>  Valid access token required to access this endpoint.

Returns all authorized store information for the specified authorization ID with pagination support.

>  This endpoint is commonly used for  functionality, allowing service providers to retrieve authorized store details and bind them to their own systems for shop onboarding.

HOST: 

DIRECTION:


  


Endpoint: GET /oauth/authorized/{authId}/merchantInfo
Version: v.1.0.6
Security: OAuth2, Sig

## Path parameters:

  - `authId` (string, required)
    Authorization ID that uniquely identifies a specific authorization session.  Each authorization generates a unique authId. There are two ways to obtain the authId:  1. Merchant authorization redirect - the authId is included in the redirect URL         2. Keeta Authorization Webhook - the authId is provided in the webhook payload  Please refer to the following for the specific workflow:Merchant Self-serve Authorization

## Query parameters:

  - `pageNum` (integer)
    Page number starting from 1

  - `pageSize` (integer)
    Number of items per page

## Response 200 fields (application/json):

  - `userId` (integer, required)
    Keeta brand account ID
    Example: 12345678

  - `brandId` (integer, required)
    Keeta brand ID
    Example: 1001

  - `brandName` (string, required)
    Keeta brand name
    Example: "Sample Brand"

  - `authorizedShops` (array, required)
    List of authorized stores

  - `authorizedShops.id` (integer, required)
    Unique store identifier
    Example: 159416882

  - `authorizedShops.name` (string, required)
    Store name
    Example: "stbaxi3 - API Test store"

  - `authorizedShops.address` (string, required)
    Store address
    Example: "Rua Augusta, 500, São Paulo, SP, Brasil"

  - `authorizedShops.longitude` (number, required)
    Longitude coordinate
    Example: 46.049568

  - `authorizedShops.latitude` (number, required)
    Latitude coordinate
    Example: -18.770281

  - `authorizedShops.timeZone` (string, required)
    Time zone information
    Example: "America/Sao_Paulo"

  - `page` (object, required)

  - `page.pageNum` (integer, required)
    Current page number starting from 1
    Example: 1

  - `page.pageSize` (integer, required)
    Number of items per page
    Example: 10

  - `page.totalPage` (integer, required)
    Total number of pages
    Example: 1

  - `page.totalCount` (integer, required)
    Total number of records
    Example: 3

## Response 401 fields (application/problem+json):

  - `title` (string, required)
    Short description of the problem.
    Example: "Unexpected error"

  - `status` (integer, required)
    HTTP code of the returned status.
    Example: 500

## Response 404 fields (application/problem+json):

  - `title` (string, required)
    Short description of the problem.
    Example: "Unexpected error"

  - `status` (integer, required)
    HTTP code of the returned status.
    Example: 500

## Response 503 fields (application/problem+json):

  - `title` (string, required)
    Short description of the problem.
    Example: "Unexpected error"

  - `status` (integer, required)
    HTTP code of the returned status.
    Example: 500