Picker business API

The business API from Picker — 40 operation(s) for business.

Operations 42

GET /api/webhooks Return the webhooks that the user is subscribed to #
POST /api/webhooks Add a webhook to subscribe to an event #
DELETE /api/webhooks Delete a webhook the user is subscribed to #
GET /business/getAccountInfoIntegrationDashboard Get General info about specific business #
GET /business/getAssociatedBusiness Get General info about businesses #
GET /business/getBookingsDataByDatesDashboard Get General info about businesses #
GET /business/getBookingsIntegrationDashboard Get General info about businesses #
GET /business/getBusinessInfoAfterLanding Get business info for landing #
GET /business/getBusinessesGeneralInfo Get General info about businesses #
GET /business/landing Get business info for landing #
GET /business/reports Get business booking reports #
GET /business/turnOffOnBusinessById Get General info about specific business #
PUT /business/addCategoryToBusiness Adds a businessCategory to the business #
PUT /business/changeProductStatus Change product status to active or inactive #
PUT /business/confirmInformation Fill information of the business after creation. #
PUT /business/editProduct Edits the information of a product #
PUT /business/editProductDetail Edit the details of a product #
PUT /business/goOnOffDuty Go on or off duty #
PUT /business/setNewPassword Set New Password #
PUT /business/updateProductCategory Update a product category #
POST /admin/restartSearch Restart driver search of selected booking #
POST /api/validateApiPickup #
POST /business/addBusiness Register a new business via Email #
POST /business/addProductDetail Add a new detail to a product #
POST /business/createBusinessForUser Create a business for a user and assign to it #
POST /business/createProduct Register a new product of a business #
POST /business/createProductByUserId Register a new product of a business #
POST /business/createProductCategory Register a new product category #
POST /business/createProductCategoryByUserId Register a new product category #
POST /business/forgotPassword Sets the deleted flag of the product to true #
POST /business/registerFromEmail Register a new business via Email #
POST /business/setProductAndCategoriesOrder Generate a dynamic link for business #
POST /business/updateBusiness Update business data #
POST /business/updateBusinessByUserId Update business data #
POST /business/updatePaymentMethodByUserId Update business payment method #
POST /business/verifyOTP Verify OTP for mobile #
POST /customer/addRemoveFavorite Customer can add or remove his favourite business or product #
DELETE /business/deleteCategory Delete a category and all its products #
DELETE /business/deleteProduct Sets the deleted flag of the product to true #
DELETE /business/deleteProductDetail Deletes the detail of a product #
DELETE /business/removeCategoryFromBusiness Removes a category from the business businessCategories array #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/picker-business-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

picker-business-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Picker Production Documentation accounting Business API
  version: V1.0.0
  contact:
    name: RV
    email: rachit.verma@nextjuggernaut.com
servers:
- url: http://api.pickerexpress.com/
tags:
- name: business
paths:
  /api/webhooks:
    get:
      summary: Return the webhooks that the user is subscribed to
      operationId: getApiWebhooks
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
    post:
      summary: Add a webhook to subscribe to an event
      operationId: postApiWebhooks
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Model_61'
    delete:
      summary: Delete a webhook the user is subscribed to
      operationId: deleteApiWebhooks
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Model_81'
  /business/getAccountInfoIntegrationDashboard:
    get:
      summary: Get General info about specific business
      operationId: getBusinessGetaccountinfointegrationdashboard
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      - name: userId
        in: query
        required: false
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
  /business/getAssociatedBusiness:
    get:
      summary: Get General info about businesses
      operationId: getBusinessGetassociatedbusiness
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      - name: storeType
        in: query
        required: false
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: number
      - name: skip
        in: query
        required: false
        schema:
          type: number
      - name: search
        in: query
        required: false
        schema:
          type: string
      - name: sortField
        in: query
        required: false
        schema:
          type: string
      - name: sortOrder
        in: query
        required: false
        schema:
          type: string
      - name: status
        in: query
        required: false
        schema:
          type: boolean
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
  /business/getBookingsDataByDatesDashboard:
    get:
      summary: Get General info about businesses
      operationId: getBusinessGetbookingsdatabydatesdashboard
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      - name: fromDate
        in: query
        required: true
        schema:
          type: string
      - name: toDate
        in: query
        required: true
        schema:
          type: string
      - name: isSemester
        in: query
        required: false
        schema:
          type: boolean
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
  /business/getBookingsIntegrationDashboard:
    get:
      summary: Get General info about businesses
      operationId: getBusinessGetbookingsintegrationdashboard
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      - name: userID
        in: query
        required: false
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
  /business/getBusinessInfoAfterLanding:
    get:
      summary: Get business info for landing
      operationId: getBusinessGetbusinessinfoafterlanding
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      - name: businessID
        in: query
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
  /business/getBusinessesGeneralInfo:
    get:
      summary: Get General info about businesses
      operationId: getBusinessGetbusinessesgeneralinfo
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: number
      - name: skip
        in: query
        required: false
        schema:
          type: number
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
  /business/landing:
    get:
      summary: Get business info for landing
      operationId: getBusinessLanding
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      - name: businessId
        in: query
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
  /business/reports:
    get:
      summary: Get business booking reports
      operationId: getBusinessReports
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      - name: startDate
        in: query
        required: true
        schema:
          type: string
      - name: endDate
        in: query
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
  /business/turnOffOnBusinessById:
    get:
      summary: Get General info about specific business
      operationId: getBusinessTurnoffonbusinessbyid
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      - name: businessUserId
        in: query
        required: true
        schema:
          type: string
      - name: businessId
        in: query
        required: true
        schema:
          type: string
      - name: currentStatus
        in: query
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
  /business/addCategoryToBusiness:
    put:
      summary: Adds a businessCategory to the business
      operationId: putBusinessAddcategorytobusiness
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                businessCategoryID:
                  type: string
                  maxLength: 24
                  minLength: 24
                  description: ID of the business category
              required:
              - businessCategoryID
  /business/changeProductStatus:
    put:
      summary: Change product status to active or inactive
      operationId: putBusinessChangeproductstatus
      parameters:
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                status:
                  type: string
                productID:
                  type: string
                  maxLength: 24
                  minLength: 24
                  description: ID of the product
              required:
              - status
              - productID
  /business/confirmInformation:
    put:
      summary: Fill information of the business after creation.
      operationId: putBusinessConfirminformation
      parameters:
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                companyName:
                  type: string
                  minLength: 2
                imageLogo:
                  type: object
                  description: image url
                imageFront:
                  type: object
                  description: image url
                businessCategories:
                  type: array
                  items:
                    type: string
                  maxItems: 3
                  description: Categories that the business is part of. Just the ID
                productTypes:
                  type: array
                  items:
                    type: string
                  maxItems: 3
                  description: Product types that the business is part of. Just the ID
                fullAddress:
                  type: string
                  minLength: 2
                  description: Full address of the business' location.
                latitude:
                  type: number
                  description: Latitude of the business' location.
                longitude:
                  type: number
                  description: Longitude of the business' location.
                schedule:
                  type: array
                  items:
                    type: object
                    properties:
                      day:
                        type: number
                        minimum: 0
                        maximum: 6
                      open:
                        type: string
                        description: Hour the business opens HH:mm
                      close:
                        type: string
                        description: Hour the business closes HH:mm
                      isOpen:
                        type: boolean
                    required:
                    - day
                    - isOpen
                    optional:
                    - open
                    - close
                role:
                  type: string
              required:
              - companyName
              - fullAddress
              - latitude
              - longitude
              - schedule
              - role
  /business/editProduct:
    put:
      summary: Edits the information of a product
      operationId: putBusinessEditproduct
      parameters:
      - description: en/ar
        name: content-language
        in: header
        required: false
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 3
                image:
                  type: object
                  description: image url
                timeToPrepare:
                  type: number
                isActive:
                  type: boolean
                price:
                  type: number
                description:
                  type: string
                category:
                  type: string
                  maxLength: 24
                  minLength: 24
                  description: ID of the category of the product
                _id:
                  type: string
                  maxLength: 24
                  minLength: 24
                  description: ID of the product
                details:
                  type: array
                  items:
                    type: string
                isDeleted:
                  type: boolean
                productType:
                  type: string
                  description: Type of product. Related to the categories that the business belongs to.
                commission:
                  type: number
                  maximum: 100
                  minimum: 0
                  description: Commission charged to the product
                images:
                  type: array
                  items:
                    type: object
                    properties:
                      image:
                        type: object
                        description: Image object with original and thumbnail
                        properties:
                          thumbnail:
                            type: string
                          original:
                            type: string
                        required:
                        - thumbnail
                        - original
                        name: image
                      isDefault:
                        type: boolean
                        description: If the image is the default product's image
                    required:
                    - image
                    - isDefault
                tags:
                  type: array
                  items:
                    type: string
                  description: Tags to find the product
              required:
              - name
              - timeToPrepare
              - price
              - description
              - category
              - _id
              - commission
              - images
  /business/editProductDetail:
    put:
      summary: Edit the details of a product
      operationId: putBusinessEditproductdetail
      parameters:
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                detailID:
                  type: string
                  maxLength: 24
                  minLength: 24
                  description: ID of the product detail
                type:
                  type: string
                  enum:
                  - SIMPLE
                  - MULTIPLE
                  - TEXT
                  description: 'Type of detail: SIMPLE | MULTIPLE | TEXT'
                default:
                  type: string
                  description: ID of the option that is selected as default
                isObligatory:
                  type: boolean
                  description: Indicates if the detail is obligatory
                options:
                  type: array
                  items:
                    type: string
                  description: Options to show to the customer
                text:
                  type: string
                  description: Description of the detail
              required:
              - detailID
              - type
              - isObligatory
  /business/goOnOffDuty:
    put:
      summary: Go on or off duty
      operationId: putBusinessGoonoffduty
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                onDutyFlag:
                  type: boolean
                  description: New value of onDutyFlag
              required:
              - onDutyFlag
  /business/setNewPassword:
    put:
      summary: Set New Password
      operationId: putBusinessSetnewpassword
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                mobile:
                  type: string
                  description: Phone number that is being verified
                password:
                  type: string
                  minLength: 6
                  description: password must contains minimum 6 character
              required:
              - mobile
              - password
  /business/updateProductCategory:
    put:
      summary: Update a product category
      operationId: putBusinessUpdateproductcategory
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 3
                _id:
                  type: string
                  maxLength: 24
                  minLength: 24
                  description: ID of the product category
              required:
              - name
              - _id
  /admin/restartSearch:
    post:
      summary: Restart driver search of selected booking
      operationId: postAdminRestartsearch
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                bookingID:
                  type: string
                  maxLength: 24
                  minLength: 24
                preSelectedProviders:
                  type: array
                  items:
                    type: string
                tip:
                  type: number
                cancelOnlySelectedProviders:
                  type: boolean
                isAdmin:
                  type: boolean
                isBusiness:
                  type: boolean
              required:
              - bookingID
  /api/validateApiPickup:
    post:
      operationId: postApiValidateapipickup
      parameters:
      - description: Bearer Token
        name: authorization
        in: header
        required: true
        schema:
          type: string
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Model_60'
  /business/addBusiness:
    post:
      summary: Register a new business via Email
      operationId: postBusinessAddbusiness
      parameters:
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                email:
                  type: string
                deviceType:
                  type: string
                  enum:
                  - WEB
                  - ANDROID
                  - IOS
                deviceToken:
                  type: string
                mobile:
                  type: string
                  minLength: 5
                  pattern: /^[0-9]+$/
                countryCode:
                  type: string
                  description: '+593'
                companyName:
                  type: string
                  minLength: 2
                imageLogo:
                  type: object
                  description: image url
                imageFront:
                  type: object
                  description: image url
                fullAddress:
                  type: string
                  minLength: 2
                addressReference:
                  type: string
                exterior:
                  type: string
                interior:
                  type: string
                zipCode:
                  type: string
                country:
                  type: string
                city:
                  type: string
                latitude:
                  type: number
                longitude:
                  type: number
                businessCategories:
                  type: array
                  items:
                    type: string
                  maxItems: 3
                  description: Categories that the business is part of. Just the ID
                schedule:
                  type: array
                  items:
                    type: object
                    properties:
                      day:
                        type: number
                        minimum: 0
                        maximum: 6
                      open:
                        type: string
                      close:
                        type: string
                      isOpen:
                        type: boolean
                    required:
                    - day
                    - isOpen
                    optional:
                    - open
                    - close
                tags:
                  type: array
                  items:
                    type: string
                  description: Tags to find the business
              required:
              - email
              - deviceType
              - mobile
              - countryCode
              - companyName
              - fullAddress
  /business/addProductDetail:
    post:
      summary: Add a new detail to a product
      operationId: postBusinessAddproductdetail
      parameters:
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                productID:
                  type: string
                  maxLength: 24
                  minLength: 24
                  description: ID of the product this detail belongs to
                type:
                  type: string
                  enum:
                  - SIMPLE
                  - MULTIPLE
                  - TEXT
                  description: 'Type of detail: SIMPLE | MULTIPLE | TEXT'
                default:
                  type: string
                  description: ID of the option that is selected as default
                isObligatory:
                  type: boolean
                  description: Indicates if the detail is obligatory
                options:
                  type: array
                  items:
                    type: string
                  description: Options to show to the customer
                text:
                  type: string
                  description: Description of the detail
              required:
              - productID
              - type
              - isObligatory
  /business/createBusinessForUser:
    post:
      summary: Create a business for a user and assign to it
      operationId: postBusinessCreatebusinessforuser
      parameters:
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                country:
                  type: string
                currency:
                  type: string
                options:
                  type: array
                  items:
                    type: string
                  description: Options for business
                storeType:
                  type: string
              required:
              - country
              - currency
              - storeType
  /business/createProduct:
    post:
      summary: Register a new product of a business
      operationId: postBusinessCreateproduct
      parameters:
      - description: en/ar
        name: content-language
        in: header
        required: true
        schema:
          type: string
      tags:
      - business
      responses:
        default:
          description: Successful
          content:
            application/json:
              schema:
                type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 3
                image:
                  type: object
                  description: image url
                timeToPrepare:
                  type: number
                isActive:
                  type: boolean
                price:
                  type: number
                description:
                  type: string
                categoryID:
                  type: string
                  maxLength: 24
                  minLength: 24
                  description: ID of the category of the product
                details:
                  type: array
                  items:
                    type: string
                productType:
                  type: string
                  description: Type of product. Related to the categories that the business belongs to.
                commission:
                  type: number
                  maximum: 100
                  minimum: 0
                  description: Commission charged to the product
                images:
                  type: array
                  items:
               

# --- truncated at 32 KB (57 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/picker/refs/heads/main/openapi/picker-business-api-openapi.yml