GF Pick Saudi API
The saudi API from GF Pick — 1 operation(s) for saudi.
The saudi API from GF Pick — 1 operation(s) for saudi.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/gfpick-com:gfpick-com-saudi-api"
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.
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: 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)