> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zodia-custody.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome

<div className="relative overflow-hidden bg-[radial-gradient(circle_at_top_right,_rgba(2,121,120,0.32),_transparent_32%),linear-gradient(135deg,#02242f_0%,#033643_52%,#027978_100%)]">
  <video autoPlay muted loop playsInline className="absolute inset-0 h-full w-full object-cover" aria-hidden src="https://zodia-custody.com/wp-content/themes/zodia/videos/bg.mp4" />

  <div className="relative z-10 mx-auto grid max-w-7xl grid-cols-1 gap-10 px-4 py-16 sm:px-6 sm:py-20 lg:grid-cols-12 lg:items-center lg:px-8">
    <div className="lg:col-span-10">
      <h1 className="text-4xl font-bold tracking-tight text-white sm:text-5xl lg:text-6xl">
        Welcome to Zodia API Documentation.
      </h1>

      <p className="mt-5 max-w-2xl text-base leading-7 text-[#d8f3f0] sm:text-lg lg:text-xl">
        Build secure custody and settlement workflows with signed API requests, maker-checker approvals, and institution-ready operational guides.
      </p>

      <div className="mt-8 flex flex-col gap-3 sm:flex-row sm:flex-wrap sm:items-center sm:gap-4">
        <a href="#quick-start" className="inline-flex items-center justify-center rounded-full bg-[#027978] px-6 py-3 text-sm font-semibold text-white no-underline transition-colors hover:bg-[#038f8e]">
          Get Started
        </a>

        <a href="/whats-new" className="inline-flex items-center justify-center rounded-full bg-[#027978] px-6 py-3 text-sm font-semibold text-white no-underline transition-colors hover:bg-[#038f8e]">
          What's New
        </a>

        <a href="/introduction" className="inline-flex items-center justify-center rounded-full border border-white/30 bg-white/10 px-6 py-3 text-sm font-semibold text-white no-underline transition-colors hover:bg-white/15">
          Explore API Reference
        </a>
      </div>
    </div>
  </div>
</div>

<section id="quick-start" className="mt-16">
  <div className="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8">
    <div>
      <h2 className="text-3xl font-bold text-gray-900 dark:text-white sm:text-4xl">Quick Start</h2>

      <p className="mt-3 max-w-3xl text-base text-gray-600 dark:text-gray-400">
        Follow the core setup path from onboarding and credentials to authentication and your first signed request.
      </p>
    </div>

    <div className="mt-10">
      <Steps>
        <Step title="Review the platform basics">
          Start with [Introduction](/introduction) and [Working with APIs](/working-with-apis) to understand the custody workflow, TLS requirements, and maker-checker model.
        </Step>

        <Step title="Generate and register your credentials">
          Create your company RSA keys and API user ECC keys before calling the API.

          * [Company Onboarding For API Interaction](/working-with-apis/company-onboarding)
          * [Onboarding API Users](/introduction)
        </Step>

        <Step title="Sign your first request">
          Use the authentication guides to create the request signature and submit a signed API call.

          ```bash theme={null}
          curl --request POST 'https://hostname.zodia.io/v3/api/servicedesk/products' \
          --header 'company-identifier: YOUR_COMPANY' \
          --header 'submitter-id: api-maker@your-company.com' \
          --header 'request-identifier: UUID' \
          --header 'request-timestamp: EPOCH_MS' \
          --header 'Content-Type: application/json' \
          --header 'signature: BASE64_SIGNATURE' \
          --data-raw '{"productIds":["0x0013"]}'
          ```

          <Note>
            Continue with [Authentication](/authentication) and [Signing Requests](/authentication/signing-requests) for the complete signing rules and payload examples.
          </Note>
        </Step>

        <Step title="Start with a guided workflow">
          Pick a full guide to move from setup into real operational flows:

          * [Wallet Creation Using Digital Asset Service Desk](/service-desk-guide/wallet-creation)
          * [Beneficiary Creation Using Digital Asset Service Desk](/service-desk-guide/beneficiary-creation)
          * [Instruct a Transfer (Wallet to a Whitelisted Address)](/service-desk-guide/instruct-transfer)
        </Step>
      </Steps>
    </div>
  </div>
</section>

<section className="mt-20">
  <div className="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8">
    <div>
      <h2 className="text-3xl font-bold text-gray-900 dark:text-white sm:text-4xl">API Reference</h2>

      <p className="mt-3 max-w-3xl text-base text-gray-600 dark:text-gray-400">
        Explore the documentation by topic, from onboarding and authentication through service workflows, settlements, and operational references.
      </p>
    </div>

    <div className="mt-10">
      <CardGroup cols={3}>
        <Card title="Working with APIs" icon="book-open" href="/working-with-apis" cta="Open section">
          Learn the platform basics, prerequisites, rate limits, pagination, and shared error models.
        </Card>

        <Card title="Authentication" icon="key" href="/authentication" cta="Review auth">
          Understand signed headers, company signatures, and maker or authoriser payload signing.
        </Card>

        <Card title="Service Desk Guide" icon="diagram-project" href="/service-desk-guide" cta="View workflows">
          Follow end-to-end workflows for wallets, beneficiaries, whitelisting, and outbound transfers.
        </Card>

        <Card title="Interchange Guide" icon="arrows-rotate" href="/interchange-guide" cta="Explore settlements">
          Review approval modes and setup flows for clients and trading venues.
        </Card>

        <Card title="Webhooks" icon="bell" href="/webhooks" cta="See delivery options">
          Configure REST or JMS notifications for wallet, beneficiary, and transfer lifecycle events.
        </Card>

        <Card title="Status Reference" icon="list-check" href="/status-reference" cta="Check statuses">
          Map request, wallet, transfer, and interchange settlement statuses to human-readable meanings.
        </Card>
      </CardGroup>
    </div>
  </div>
</section>

<section className="mt-20">
  <div className="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8">
    <div>
      <h2 className="text-3xl font-bold text-gray-900 dark:text-white sm:text-4xl">Resources</h2>

      <p className="mt-3 max-w-3xl text-base text-gray-600 dark:text-gray-400">
        Reach the team, follow company updates, and jump into the most commonly used supporting pages.
      </p>
    </div>

    <div className="mt-10">
      <CardGroup cols={3}>
        <Card title="FAQs" icon="circle-question" href="/faqs" cta="Read answers">
          Review common implementation questions around pagination, signatures, beneficiaries, and wallet workflows.
        </Card>

        <Card title="Support" icon="life-ring" href="https://zodia-custody.com/contact/" cta="Contact Zodia">
          Reach the Zodia team for onboarding help, integration questions, and operational support.
        </Card>

        <Card title="Community" icon="linkedin" href="https://www.linkedin.com/company/zodiacustody?originalSubdomain=uk" cta="Follow updates">
          Stay connected with company news, product updates, and broader digital asset custody announcements.
        </Card>

        <Card title="AI Resources" icon="life-ring" href="ai-guides/claude-code-onboarding" cta="AI resources">
          A collection of AI prompts to help get the most from this documentation and our services.
        </Card>
      </CardGroup>
    </div>
  </div>
</section>

<section className="my-20">
  <div className="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8">
    <div className="rounded-3xl border border-[#b6e7e3] bg-[#e8fbf9] px-6 py-10 dark:border-[#0f525c] dark:bg-[#05262c] sm:px-10">
      <h2 className="text-3xl font-bold text-gray-900 dark:text-white sm:text-4xl">
        Ready to build?
      </h2>

      <p className="mt-3 max-w-2xl text-base text-gray-700 dark:text-gray-300">
        Start with the onboarding and authentication guides, then move into the
        service desk workflows that match your integration path.
      </p>

      <div className="mt-6 flex flex-col gap-3 sm:flex-row sm:flex-wrap">
        <a href="#quick-start" className="inline-flex items-center justify-center rounded-full bg-[#027978] px-6 py-3 text-sm font-semibold text-white no-underline transition-colors hover:bg-[#038f8e]">
          Start the Quick Start
        </a>

        <a href="/authentication" className="inline-flex items-center justify-center rounded-full border border-[#027978]/30 px-6 py-3 text-sm font-semibold text-[#027978] no-underline transition-colors hover:bg-[#027978]/5 dark:border-[#4ecfca]/30 dark:text-[#7de5df] dark:hover:bg-white/5">
          Go to Authentication
        </a>
      </div>
    </div>
  </div>
</section>