---
title: "GET /v1/businesses"
method: GET
path: "/v1/businesses"
tags: ["Business"]
---

# GET /v1/businesses

`GET /v1/businesses`

Returns the merchant's business information. Required permissions: `profile`

## Response `200`

Businesses response

- object
  - `data` object
    - `business` Business — Current user business
      - `id` integer
      - `name` string
      - `address` string
      - `suite` string
      - `city` string
      - `province` string
      - `postal_code` string
      - `description` string
      - `email` string
      - `phone` string
      - `logo` string
      - `notify_per_deposit` boolean
      - `notify_per_trans` boolean
      - `user_id` integer
      - `is_deleted` boolean
      - `created_at` string
      - `updated_at` string
      - `business_type_id` integer
      - `business_category_id` integer
      - `website` string
      - `twitter` string
      - `facebook` string
      - `instagram` string
      - `notes` string
      - `latitude` unknown
      - `longitude` unknown
      - `synchronized_at` string
      - `outlet_slot` integer
      - `is_trial` boolean
      - `current_plan` integer
      - `expired_at` string
      - `last_payment_date` string
      - `trial_end_at` string
  - `meta` MetadataProperty
    - `code` integer
    - `errors` object

## Other responses

- `400` — Bad parameter
- `401` — The access token is invalid
- `403` — Access token valid, but is denied to access the resource. Or, the merchant`s outlet is expired.
- `410` — API Deprecated
- `415` — Unsupported Media Type
- `500` — Internal Server Error

---

[API](https://skmtc.dev/mokapos/apis/moka-api.md) · [All operations](https://skmtc.dev/mokapos/apis/moka-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mokapos/moka-api/revisions/eea24d9b5965/schema)