GF Pick Saudi API

The saudi API from GF Pick — 1 operation(s) for saudi.

GitHub OpenAPI

Operations 1

POST /v1/sa/landed-cost Saudi Landed Cost — 0.25 USDC #

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/gfpick-com:gfpick-com-saudi-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

gfpick-com-saudi-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Gfpick Com Saudi API
  version: 2.3.1
  contact:
    name: GF Pick
    url: https://www.gfpick.com
  description: 'Operations tagged saudi across 2 of this provider''s published API definitions: openapi.json, gfpick-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.gfpick.com
- url: https://gf-agent-toll.vercel.app
tags:
- name: saudi
paths:
  /v1/sa/landed-cost:
    post:
      operationId: sa_landed_cost
      tags:
      - saudi
      summary: Saudi Landed Cost — 0.25 USDC
      description: Saudi import landed-cost calculation.
      parameters:
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        schema:
          type: string
      - name: X-Referral-Code
        in: header
        required: false
        schema:
          type: string
          maxLength: 64
      - name: Idempotency-Key
        in: header
        required: false
        schema:
          type: string
          maxLength: 200
      - name: X-Request-ID
        in: header
        required: false
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LandedCostInput'
            example:
              currency: SAR
              product_value: 100
              shipping: 20
              insurance: 0
              duty_rate_pct: 5
              vat_rate_pct: 15
      responses:
        '200':
          description: Successful structured result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentResult'
        '400':
          description: Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '402':
          description: x402 v2 payment required. This challenge is returned before paid request-body schema validation. Read PAYMENT-REQUIRED, sign with the caller wallet, then retry.
          headers:
            PAYMENT-REQUIRED:
              description: Base64/JSON x402 v2 payment challenge.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402PaymentRequired'
        '429':
          description: Rate limited
        '502':
          description: Core unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Circuit open
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-x402-price-usdc: 0.25
      x-x402-network: eip155:8453
      x-bazaar-input:
        info:
          input:
            type: http
            method: POST
            bodyType: json
            body:
              currency: SAR
              product_value: 100
              shipping: 20
              insurance: 0
              duty_rate_pct: 5
              vat_rate_pct: 15
          serviceName: GF Agent Toll — Saudi Landed Cost
          tags:
          - saudi
          - landed-cost
          - import
        schema:
          $schema: https://json-schema.org/draft/2020-12/schema
          type: object
          properties:
            input:
              type: object
              properties:
                type:
                  const: http
                method:
                  const: POST
                bodyType:
                  const: json
                body:
                  type: object
                  additionalProperties: false
                  required:
                  - product_value
                  properties:
                    currency:
                      type: string
                      description: Scenario currency.
                    product_value:
                      type: number
                      description: Product purchase value.
                      minimum: 0.01
                      maximum: 1000000000000
                    shipping:
                      type: number
                      description: Shipping cost.
                    insurance:
                      type: number
                      description: Insurance cost.
                    duty_rate_pct:
                      type: number
                      description: Customs duty percentage.
                    vat_rate_pct:
                      type: number
                      description: VAT percentage.
              required:
              - type
              - method
              - bodyType
              - body
          required:
          - input
      x-x402-challenge-before-body-validation: true
      x-agent-retry-safe: true
      x-agent-canonical-origin: https://api.gfpick.com
    servers:
    - url: https://api.gfpick.com
    - url: https://gf-agent-toll.vercel.app
components:
  schemas:
    X402PaymentRequired:
      type: object
      description: x402 v2 payment challenge. Sign an accepted authorization in the caller wallet and retry the same request with PAYMENT-SIGNATURE.
      additionalProperties: true
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          - request_id
          - retryable
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
            retryable:
              type: boolean
            details:
              type: array
              items:
                type: object
                additionalProperties: true
    AgentResult:
      type: object
      description: Structured GF Agent Toll result. Fields vary by selected commerce analysis tool.
      additionalProperties: true
    LandedCostInput:
      type: object
      additionalProperties: false
      required:
      - product_value
      properties:
        currency:
          type: string
          description: Scenario currency.
        product_value:
          type: number
          description: Product purchase value.
          minimum: 0.01
          maximum: 1000000000000
        shipping:
          type: number
          description: Shipping cost.
        insurance:
          type: number
          description: Insurance cost.
        duty_rate_pct:
          type: number
          description: Customs duty percentage.
        vat_rate_pct:
          type: number
          description: VAT percentage.
externalDocs:
  description: Developer Hub
  url: https://api.gfpick.com/developers
x-refined-from:
- openapi.json
- gfpick-com-openapi.json
x-agent-discovery:
  canonicalAgent: https://api.gfpick.com
  settlementCore: https://gf-agent-toll.vercel.app
  legacyCore: https://gf-agent-toll.vercel.app
  x402: https://api.gfpick.com/.well-known/x402
  catalog: https://api.gfpick.com/.well-known/x402-catalog.json
  bazaar: https://api.gfpick.com/.well-known/x402-bazaar.json
  openapi: https://api.gfpick.com/openapi.json
  mcp: https://api.gfpick.com/mcp
  a2a: https://api.gfpick.com/.well-known/agent-card.json
  identity: https://api.gfpick.com/identity
  jwks: https://api.gfpick.com/.well-known/jwks.json
  skill: https://api.gfpick.com/skill.md
  llms: https://api.gfpick.com/llms.txt
  developers: https://api.gfpick.com/developers
  payments: https://api.gfpick.com/payment-capabilities.json
  compatibility: https://api.gfpick.com/.well-known/compatibility.json
x-compatibility:
  service: GF Agent Toll
  version: 2.3.1
  policy:
    robot_interoperability_is_top_priority: true
    native_protocol_first: true
    advertise_only_working_capabilities: true
    preserve_free_access: true
    preserve_existing_x402_base_usdc: true
    unsupported_payment_methods_are_never_added_to_x402_accepts: true
    incoming_customer_payments_need_operator_approval: false
    outgoing_external_payments_need_operator_approval: true
  robot_priority:
    service: GF Agent Toll
    version: 2.3.1
    policy:
      mode: native-protocol-first
      priority: 1
      equal_priority_for_verified_robot_classes: true
      never_user_agent_sniff_for_protocol_selection: true
      advertise_only_verified_capabilities: true
      canonical_before_legacy: true
      free_discovery_and_free_qualification_remain_available: true
    robot_classes:
      mcp_agents:
        priority: 100
        active: true
        canonical:
          version: '2026-07-28'
          transport: streamable-http
          url: https://api.gfpick.com/mcp
        local_fallback:
          transport: stdio
          command: npm run mcp:stdio
      a2a_agents:
        priority: 100
        active: true
        canonical_version: '1.0'
        discovery: https://api.gfpick.com/.well-known/agent-card.json
        preferred_interfaces:
        - protocolBinding: JSONRPC
          protocolVersion: '1.0'
          url: https://api.gfpick.com/a2a/rpc
        - protocolBinding: HTTP+JSON
          protocolVersion: '1.0'
          url: https://api.gfpick.com
        legacy_fallback:
          protocolVersion: '0.3'
          active: true
      openapi_http_agents:
        priority: 100
        active: true
        canonical: https://api.gfpick.com/openapi.json
        aliases:
        - https://api.gfpick.com/.well-known/openapi.json
        - https://api.gfpick.com/swagger.json
        - https://api.gfpick.com/api/openapi.json
      local_desktop_agents:
        priority: 100
        active: true
        protocol: MCP
        transport: stdio
        command: npm run mcp:stdio
      llm_indexers_and_crawlers:
        priority: 100
        active: true
        discovery:
        - https://api.gfpick.com/llms.txt
        - https://api.gfpick.com/agents.txt
        - https://api.gfpick.com/robots.txt
        - https://api.gfpick.com/sitemap.xml
      x402_payment_agents:
        priority: 100
        active: true
        protocol: x402
        version: 2
        discovery: https://api.gfpick.com/.well-known/x402
        network: eip155:8453
        asset: USDC
    selection_policy:
      mcp_client: use MCP directly
      a2a_client: use A2A 1.0 directly; fall back to 0.3 only when required
      generic_tool_client: use OpenAPI/HTTP JSON
      local_process_client: use MCP stdio
      crawler_or_llm_indexer: use llms.txt + agents.txt + sitemap.xml
      payment_capable_agent: discover x402 after selecting the native application protocol
    compatibility_aliases:
      robot_priority: https://api.gfpick.com/.well-known/robot-priority.json
      robot_discovery: https://api.gfpick.com/robot-discovery.json
      openapi_well_known: https://api.gfpick.com/.well-known/openapi.json
      swagger: https://api.gfpick.com/swagger.json
      openapi_api_path: https://api.gfpick.com/api/openapi.json
      llms_well_known: https://api.gfpick.com/.well-known/llms.txt
      agent_card_short: https://api.gfpick.com/agent-card.json
      mcp_manifest_short: https://api.gfpick.com/mcp.json
    quality_gates:
      mcp_official_v2_client_http: true
      mcp_official_v2_client_stdio: true
      a2a_official_must_tck_jsonrpc: true
      a2a_official_must_tck_http_json: true
      a2a_official_must_tck_grpc: true
      contract_tests: true
      live_smoke: true
  robot_transports:
    http_openapi:
      active: true
      priority: 100
      url: https://api.gfpick.com/openapi.json
    mcp_streamable_http:
      active: true
      priority: 100
      version: '2026-07-28'
      url: https://api.gfpick.com/mcp
    mcp_stdio:
      active: true
      priority: 100
      mode: local-process
      command: npm run mcp:stdio
      note: For desktop/CLI agents that spawn MCP servers locally; the process proxies to the same GF Agent Toll core.
    a2a_jsonrpc:
      active: true
      priority: 100
      canonicalVersion: '1.0'
      legacyVersions:
      - '0.3'
      url: https://api.gfpick.com/a2a/rpc
    a2a_http_json:
      active: true
      priority: 100
      canonicalVersion: '1.0'
      legacyVersions:
      - '0.3'
      acceptedMediaTypes:
      - application/a2a+json
      - application/json
      url: https://api.gfpick.com
    a2a_grpc:
      active: false
      implementation_ready: true
      url: null
      reason: Implementation and TCK gate are present; current Vercel HTTP deployment cannot accept inbound gRPC.
      activation_requires:
      - gRPC-capable public host
      - TLS
      - set A2A_GRPC_ACTIVE=1
      - set A2A_GRPC_URL
      - production A2A gRPC TCK
  payments:
    direction_policy:
      inbound_customer:
        mode: automatic-inbound
        direction: customer-to-gf
        manualOperatorApprovalRequired: false
        automaticAcceptance: true
        payerAuthorizationRequired: true
        rails:
          x402_wallet:
            role: direct-service-settlement
            automaticSettlementAfterPayerSignature: true
            operatorApprovalRequired: false
            transactionStickyAfterSignature: true
            crossProviderReplayAllowed: false
          paypal:
            role: prepaid-account-funding
            automaticCaptureAfterPayerApproval: true
            verifiedWebhookRequiredForDurableCredit: true
            directServiceSettlement: false
            operatorApprovalRequired: false
            transactionStickyAfterOrderCreation: true
            crossProviderReplayAllowed: false
          stripe_credits:
            role: prepaid-account-funding
            automaticCreditAfterVerifiedCheckoutWebhook: true
            verifiedWebhookRequiredForDurableCredit: true
            directServiceSettlement: false
            operatorApprovalRequired: false
            transactionStickyAfterCheckoutCreation: true
            crossProviderReplayAllowed: false
        commerce_channels:
          meta:
            role: commerce-and-acquisition-channel
            paymentGateway: false
            storesPaymentCredentials: false
            checkoutRails:
            - stripe
            - paypal
            providerManagedSettlementDestinationRequired: true
            operatorApprovalRequiredForInboundCustomerPayment: false
        continuity:
          chooseHealthyRailBeforeFinancialSend: true
          optionalRailFailureIsNonFatal: true
          preserveIdempotencyKey: true
          noCrossRailReplayAfterTransactionStarts: true
          outcomeUnknownRequiresSameProviderReconciliation: true
        note: Customer payments to GF do not require operator approval. x402 is the direct paid-service settlement rail. PayPal and Stripe fund durable prepaid credits only after provider verification. Meta is a commerce/acquisition channel and routes checkout to an approved Stripe or PayPal rail; it is not treated as a general settlement gateway.
      outbound_external:
        mode: human-only
        direction: gf-to-external
        manualOperatorApprovalRequired: true
        autonomousPayment: false
        autonomousSigning: false
        autonomousSettlement: false
        automaticProviderFailoverAfterFinancialSend: false
        note: GF Agent Toll may discover external payment requirements, but only an authorized human operator may approve and execute a payment from GF to an external service. Unknown financial outcomes must be reconciled on the same provider before any follow-up.
    customer_inbound:
      manual_operator_approval_required: false
      x402_wallet:
        active: true
        network: eip155:8453
        pay_to: '0x4B7098E3b882633d3205FDE3E7ac7Ea1D965D3C3'
        automatic_settlement_after_customer_signature: true
        operator_approval_required: false
      paypal:
        environment: live
        order_creation_ready: true
        automatic_capture_after_customer_approval: true
        verified_crediting_ready: true
        live_customer_funding_active: true
        operator_approval_required: false
    outbound_external:
      manual_operator_approval_required: true
      autonomous_payment: false
      autonomous_signing: false
      autonomous_settlement: false
    active:
    - id: x402-base-usdc-exact
      protocol: x402
      version: 2
      scheme: exact
      network: eip155:8453
      asset:
        symbol: USDC
        contract: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
      payTo: '0x4B7098E3b882633d3205FDE3E7ac7Ea1D965D3C3'
      settlement_core: https://gf-agent-toll.vercel.app
      direction: customer-to-gf
      operator_approval_required: false
      automatic_settlement_after_customer_signature: true
    - id: paypal-customer-funding
      protocol: paypal-orders-v2
      direction: customer-to-gf
      environment: live
      operator_approval_required: false
      customer_approval_required: true
      automatic_capture_after_customer_approval: true
      verified_crediting_ready: true
      usage: customer-funding
      service_entitlement_bridge_active: false
      create_order: https://api.gfpick.com/paypal/orders
      status: https://api.gfpick.com/paypal/status
    inactive_until_configured:
    - id: x402-solana-usdc
      protocol: x402
      version: 2
      reason: No operator-controlled Solana receiving wallet/facilitator is configured.
      activation_requires:
      - operator Solana payTo wallet
      - supported Solana USDC mint/network
      - facilitator verify+settle support
      - integration and settlement tests
    - id: enterprise-api-key-credits
      reason: No durable API-key issuer and prepaid credit ledger is connected.
      activation_requires:
      - key issuer
      - hashed key storage
      - credit ledger
      - rate/usage accounting
      - revocation
  authentication:
    public_discovery: true
    caller_wallet_keys_received_by_server: false
    a2a_identity: ES256 signed Agent Card
    enterprise_oauth:
      active: false
      target: OAuth 2.x with current MCP authorization metadata/CIMD compatibility
      activation_requires:
      - authorization server/issuer
      - client metadata policy
      - token validation
      - issuer binding
x-autonomous-purchase-policy:
  strategy: free-first, then lowest-cost paid tool that satisfies the task
  ladder:
  - service: free_profit_check
    price_usdc: 0
    role: qualification
    recommended: true
  - service: sa_landed_cost
    price_usdc: 0.25
    role: low-cost paid entry
    recommended: true
  - service: gcc_opportunity_score
    price_usdc: 0.75
    role: low-cost paid decision
    recommended: true
  - service: gcc_product_decision
    price_usdc: 2.5
    role: premium single-product decision
  - service: gcc_portfolio_rank
    price_usdc: 5
    role: multi-product ranking
  - service: gcc_merchant_pack
    price_usdc: 12
    role: merchant portfolio plan
  payment:
    protocol: x402
    version: 2
    network: eip155:8453
    asset: USDC
    payTo: '0x4B7098E3b882633d3205FDE3E7ac7Ea1D965D3C3'
  note: Never require a wallet for the free qualification call. Paid calls return HTTP 402 before payment and before request-body schema validation.
x-provenance:
  method: harvested
  publisher: GF Pick
  source: https://api.gfpick.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)