{"id":13314700,"url":"https://github.com/kontent-ai/delivery-sdk-net","last_synced_at":"2026-04-14T00:03:35.408Z","repository":{"id":38049874,"uuid":"69869792","full_name":"kontent-ai/delivery-sdk-net","owner":"kontent-ai","description":"Kontent.ai Delivery .NET SDK","archived":false,"fork":false,"pushed_at":"2025-04-09T11:15:13.000Z","size":3375,"stargazers_count":34,"open_issues_count":31,"forks_count":43,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-04-14T06:05:55.840Z","etag":null,"topics":["delivery-api","dotnet","dotnet6","hacktoberfest","headless-cms","kontent-ai","kontent-ai-tool","nuget","sdk"],"latest_commit_sha":null,"homepage":"https://www.nuget.org/packages/Kontent.Ai.Delivery","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kontent-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-10-03T12:46:58.000Z","updated_at":"2025-04-09T11:11:43.000Z","dependencies_parsed_at":"2024-06-18T18:22:23.678Z","dependency_job_id":"8e14a85f-98e1-4a01-837d-b403be4ce52f","html_url":"https://github.com/kontent-ai/delivery-sdk-net","commit_stats":{"total_commits":825,"total_committers":64,"mean_commits":12.890625,"dds":0.783030303030303,"last_synced_commit":"ccd17f7013c888a9ce5914bda99055a2b341cf90"},"previous_names":["kentico/kontent-delivery-sdk-net","kentico/deliver-.net-sdk","kentico/delivery-sdk-net"],"tags_count":80,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fdelivery-sdk-net","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fdelivery-sdk-net/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fdelivery-sdk-net/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fdelivery-sdk-net/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kontent-ai","download_url":"https://codeload.github.com/kontent-ai/delivery-sdk-net/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251196394,"owners_count":21550945,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["delivery-api","dotnet","dotnet6","hacktoberfest","headless-cms","kontent-ai","kontent-ai-tool","nuget","sdk"],"created_at":"2024-07-29T18:11:53.560Z","updated_at":"2026-04-14T00:03:35.378Z","avatar_url":"https://github.com/kontent-ai.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kontent.ai Delivery .NET SDK\n\n[![Build \u0026 Test](https://github.com/kontent-ai/delivery-sdk-net/actions/workflows/integrate.yml/badge.svg)](https://github.com/kontent-ai/delivery-sdk-net/actions/workflows/integrate.yml)\n[![codecov](https://codecov.io/gh/kontent-ai/delivery-sdk-net/branch/master/graph/badge.svg)](https://app.codecov.io/gh/kontent-ai/delivery-sdk-net)\n[![Stack Overflow](https://img.shields.io/badge/Stack%20Overflow-ASK%20NOW-FE7A16.svg?logo=stackoverflow\u0026logoColor=white)](https://stackoverflow.com/tags/kontent-ai)\n[![Discord](https://img.shields.io/discord/821885171984891914?color=%237289DA\u0026label=Kontent.ai%20Discord\u0026logo=discord)](https://discord.gg/SKCxwPtevJ)\n\n| Paradigm |                                                                  Package                                                                  |                                                                Downloads                                                                |                                                                  Compatibility                                                                   |                                Documentation                                 |\n| -------- | :---------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------: |\n| Async    |    [![NuGet](https://img.shields.io/nuget/v/Kontent.Ai.Delivery.svg)](https://www.nuget.org/packages/Kontent.Ai.Delivery)    |    [![NuGet](https://img.shields.io/nuget/dt/Kontent.Ai.Delivery.svg)](https://www.nuget.org/packages/Kontent.Ai.Delivery)    | [`net8.0`](https://dotnet.microsoft.com/download/dotnet/8.0) |                            [📖 Wiki](./docs)                             |\n| Reactive | [![NuGet](https://img.shields.io/nuget/v/Kontent.Ai.Delivery.Rx.svg)](https://www.nuget.org/packages/Kontent.Ai.Delivery.Rx) | [![NuGet](https://img.shields.io/nuget/dt/Kontent.Ai.Delivery.Rx.svg)](https://www.nuget.org/packages/Kontent.Ai.Delivery.Rx) | [`net8.0`](https://dotnet.microsoft.com/download/dotnet/8.0) | [📖 Wiki](./docs/retrieving-data/reactive-library.md) |\n\n## Summary\n\nThe Kontent.ai Delivery .NET SDK is a client library that lets you easily retrieve content from [Kontent.ai](https://kontent.ai).\n\n### Getting started\n\nInstallation via Package Manager Console in Visual Studio:\n\n```powershell\nPM\u003e Install-Package Kontent.Ai.Delivery\n```\n\nInstallation via .NET CLI:\n\n```console\n\u003e dotnet add \u003cTARGET PROJECT\u003e package Kontent.Ai.Delivery\n```\n\n## Usage\n\nTo retrieve content from your Kontent.ai environments, you'll be using an implementation of the `IDeliveryClient` interface. This is the main interface of the SDK. Here's how you can instantiate and use the Delivery client either [with DI/IoC](#use-dependency-injection-ideal-for-aspnet-core-web-apps \"Usage with dependency injection\") or [without DI/IoC](#usage-without-iocdi-containers-ideal-for-console-apps-unit-tests \"Usage without dependency injection\").\n\n### Use dependency injection (ideal for ASP.NET Core web apps)\n\n**Startup.cs**\n\n```csharp\npublic void ConfigureServices(IServiceCollection services)\n{\n\tservices.AddDeliveryClient(Configuration);\n}\n```\n\n**HomeController.cs**\n\n```csharp\npublic class HomeController\n{\n\tprivate IDeliveryClient _client;\n\n\tpublic HomeController(IDeliveryClient deliveryClient)\n\t{\n\t\t_client = deliveryClient;\n\t}\n}\n```\n\nIn this case, the SDK reads the configuration from the `DeliveryOptions` section of the `Configuration` object. There are many ways of providing the configuration to the `DeliveryClient` as well as many advanced registration scenarios which you can all find in the [Wiki](./docs/configuration/dependency-injection.md).\n\nTo see a complete working example, go to one of our sample apps:\n\n- [Kontent.ai ASP.NET Core MVC](https://github.com/kontent-ai/sample-app-net) or\n- [Kontent.ai ASP.NET Core Razor Pages](https://github.com/kontent-ai/sample-app-razorpages)\n\nTo spin up a fully configured blank site quickly, use the:\n\n- [Kontent.ai ASP.NET Core MVC boilerplate](https://github.com/kontent-ai/boilerplate-net)\n\n### Usage without IoC/DI containers (ideal for console apps, unit tests...)\n\nYou can also set up a `DeliveryOptions` manually using the [`DeliveryClientBuilder`](https://github.com/kontent-ai/delivery-sdk-net/blob/master/Kontent.Ai.Delivery/Builders/DeliveryClient/DeliveryClientBuilder.cs).\n\n```csharp\nIDeliveryClient _client = DeliveryClientBuilder\n    .WithOptions(builder =\u003e builder\n        .WithEnvironmentId(\"\u003cYOUR_ENVIRONMENT_ID\u003e\")\n\t.UseProductionApi()\n\t.Build())\n    .Build();\n```\n\n### Your first request\n\nUse the [.NET code generator](https://github.com/kontent-ai/model-generator-net) to generate POCO models:\n\n```csharp\npublic class Article\n{\n        public string Title { get; set; }\n        public string Summary { get; set; }\n\tpublic string Body { get; set; }\n\tpublic DateTime? PostDate { get; set; }\n\tpublic ContentItemSystemAttributes System { get; set; }\n}\n```\n\nCall the `IDeliveryClient` to retrieve data from Kontent:\n\n```csharp\n// Retrieving a single content item\nvar response = await _client.GetItemAsync\u003cArticle\u003e(\"\u003carticle_codename\u003e\");\nvar title = response.Item.Title; // -\u003e \"On Roasts\"\nvar lang = response.Item.System.Language; // -\u003e \"en-US\"\n```\n\nSee [Working with Strongly Typed Models](./docs/customization-and-extensibility/strongly-typed-models.md) to learn how to generate models and adjust the logic to your needs.\n\n## Further information\n\nFor more developer resources, visit:\n\n- [✔️ Best practices for Kontent.ai Delivery SDK for .NET](./docs)\n- Kontent.ai Learn:\n  - [.NET Tutorials](https://kontent.ai/learn/tutorials/develop-apps?tech=dotnet)\n  - [API Reference](https://kontent.ai/learn/reference)\n\n## Get involved\n\nCheck out the Contributing page to see the best places to file issues, start discussions, and begin contributing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkontent-ai%2Fdelivery-sdk-net","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkontent-ai%2Fdelivery-sdk-net","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkontent-ai%2Fdelivery-sdk-net/lists"}